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This publication describes the internal logic of the 
group of routines that make up the task monitor. The 
task monitor deals with the reception and control of 
those interruptions that directly concern the user of 
the system. It resides in virtual memory and is com- 
posed of ten modules. 

Program logic manuals are directed to systems 
engineers and programmers who require descriptions of 
the internal logic of a system. Together with program 
listings, they can be used to examine specific areas of 
program logic for purposes of maintaining or altering 
the system. 



PREFACE 



The task monitor resides in virtual 
storage and directs the processing of task- 
oriented interruptions. This book attempts 
to make clear the internal logic of the 
group of routines which comprise the task 
monitor. 



There are five sections in this manual. 
Section 1, the introduction, provides back- 
ground information essential to an under- 
standing of task monitor processing. Sec- 
tion 2, Method of Operation, contains a 
general overview of that processing. From 
this section the reader should be able to 
gain an understanding of how the task mon- 
itor accomplishes its objectives- Section 
3 describes program organization. It con- 
sists of flowcharts and detailed routine 
descriptions. Section *♦, Data Areas, con- 
tains a brief description of the control 
blocks used by the task monitor, and how 
they are used. Section 5, Diagnostic Aids, 
contains helpful infornetion for the cus- 
tomer engineer; for example, a microfiche 
directory and layouts of the task monitor* s 
enter tables and log. 
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INTRODUCTION 



TASK MONITOR FUNCTIONS 

The task monitor is a group of modules that receive and handle those 
interruptions that will be brought to the user's attention. They also 
provide services to the user, in the form of macro instructions, that 
enable him to handle such interruptions. The task monitor's queuing/ 
scanning mechanism provide linkage to system or user-written interrup- 
tion handling routines. These routines may be either dispatched immedi- 
ately or queued for later dispatching. The task monitor also ensures 
that the integrity of each task is maintained throughout this procedure - 

Except for SVCs 64-95 and 128-255, the interruptions listed in Table 
1 are handled by the task monitor. 



INTERRUPTIONS 



Table 
r T" 



Interruption Types CPart 1 of 2) 



I- + 

1 



Type 



I Codes j 



Description 



2 



I- i 

3 



l- + 

4 



L 



Program 






SVC 



I— 



128-255 
External 



Asynchronous I/O 



1-15 



16-17 



0-63 



64-95 



H- 



96-127 



I-" 



Indicate error conditions; such as 
illegal operations, or overflow or 
underflow in arithmetic operations. 



H 



Indicate paging C16> or segment 
(17) relocation exceptions. The 
dynamic loader must be called to 
resolve addresses in required page 
when it is first read into main 
storage. 

Usually request system services; 
may indicate error conditions. 



Reserved for users who want to spe- 
cify their own interruption- 
handling routines. 



H 



Time sharing support system (TSSS) 
S¥Cs (not received by task mon- 
itor) . These regulate ATs and pro- 
vide system services for the virtu- 
al support system CVSS) . 



Task monitor SVCs; documented in 
"SVC Interruption Processor," in 
this book. 



-i 






Handled by resident supervisor. 

Result from intertask communica- 
tion. A VSEND macro instruction is 
issued by task that wants to send 
message to another task. 

Result from I/O activity that was 
not initiated by the resident 
supervisor. Generally, they occur 
when user presses "attention" key 
on his terminal. 



I nt r oduc t i on 



Table 1. Interruption Types (Part 2 of 2) 

J. ^ ^ ^ «-.^ 

I I Type I Codes | 



Description 



Synchronous I/O 



Timer 



Real 



Task 



Task time is decremented only when 
task that set timer is in 
execution. 

Occur when I/O operations that have 
been initiated by resident supervi-- 
sor are completed. 



Occur at end of user-determined 
time interval which is set in one 
of the task monitor's clocks. 



Real time is continuously 
decremented . 



H 



H 



Virtual support 
system 



Occur (1> when VSS command is in- 
voked, (2) when task system pro- 
grairaner is connected to task (3) 
when TSSS reaches AT command 
embedded in code written by a sys- 
tem programmer. 



-4 



Data set paging 
error 



Occur when input paging errors are 
detected by resident paging 
mechanism. The task monitor will 
receive these interruptions when 
page cannot be read, device has 
been disabled, or data check error 
has occurred. 



TASK MONITOR CONTROL BLOCKS 

For easy reference, the abbreviations used in this book for control 
blocks are listed in Table 2. 



Table 2. Control Blocks 



Control Blocks 



— -i- 



I System ID | 



COM I (COMAREA) Communications area 

DCB I Data control block 

DEB I Data extent block 

ICB I Interruption control block 

ISA I Interruption save area 

ITB I Interruption table 

DE I Device entry 

RE I Request entry 

QE I Queue entry 

MCB I Message control block 

PDSA I Pushdown save area 

SDAT I Symbolic device allocation table 

TMPSECT I Task monitor prototype control section 



CHACOM 
CHADCB 
CHADEB 
CHAICB 
CHAISA 
CHAITB 
CHAIDE 
CHAIRE 
CHAIQE 
CHAMCB 
CHAPDS 
CHASDA 

.J. ^ , — ^J 



LINKAGES 

The linkages from one program to another within a task, iirtiich are of 
concern to the task iiK>nitor, and are most widely used in TSS/360 are 
type-I, type- II, and type- III, listed in Table 3. 



Table 3 • Linkages 



J. ^- 

I Linkage | 
h ¥- 



Description 



Type- I 



Type- II 



Connects privileged program to 
privileged program or nonprivileged 
program to nonprivileged program 



Connects nonprivileged program to 
privileged program. Task monitor 
provides the save area; control is 
transferred via LVPSW instruction 
through resident supervisor 



Conventions j 

Use of standard 19 -word save area 
Use of specific registers to trans- 
fer certain kinds of information 
Use of BAS (BASR) instruction to 
transfer control 
Preservation of register integrity 



Standard save area 

Standard content and use of general 

registers 

Standard method of transferring 

control from calling program to 

called program 

Preserve register integrity 



H 



H 



Type-Ill 



Connects privileged program to non- 
privileged program. The task 
monitor's leave privilege routine ob- 
tains and initializes standard save 
area. When called routine returns^ 
control will be transferred to RSPRV 
routine of task monitor S¥C inter- 
ruption processor 



Standard save area 
Standard usages of registers 
Standard method of transferring 
control from calling program to 
called program 
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USER-SPECIFIED INTERRUPTION HlkNDLHiS ROUTINES 

Systeni/360 uses interruptions to provide efficient use of system 
resources and to handle errors, A series of macro instructions is 
available to the user who may want to supply his own, interruption ser- 
vicing routines. 

Six kinds of interruptions can be handled in this way: 



I Interruption 
|.» 

Program 
SVC 

External 
Timer 

Synchronous I/O 
Asynchronous I/O 



j Macro Instruction 
4 



SPEC 

SSEC 
SEEC 
STEC 

SIEC 
SAEC 

L ^ . ^-J 



These macro instructions are used to define the user- built ICB, which 
contains : 

• Type of interruption to be serviced 

• Entry point of user-written servicing routine 

• Address of user-supplied COMAREA 

• CI/O interruptions only) address of DCB. 

Each of these oecro instructions must be followed by the specify 
interruption routine (SIR) macro instruction to identify the ICB- to the 
task monitor. SIR attaches a device entry, if necessary, and a request 
entry to the ITB and establishes the priority of this routine. 

Two methods of handling attention interruptions are also provided: 

1. SAEC - followed by SIR - used with user attention CUSffl?T) macro 
instruction 



2. Attention entry table CAETD) macro instruction. 

All user-specified interruption handling routines may be disabled by 
the user. A routine established by SIR may be deleted by the delete 
interruption routine CDIR) macro instruction. The procedure established 
by USATT may be deactivated with a clear attention CCLATT) macro 
instruction. 
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For MO Diagrams 



Large black arrow 



Entrance to and exit from diagram 



Large white arrow 
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Data flow 



Thick line 



Flow of control 



METHOD OF OPERATION KEY 



Thickly outlined box 
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Control block 



Thin line 



Pointer 



Thinly outlined box 
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TASK MONITOR ROUTINES 



Main module (CZCJT) 



Macro routines 



Timer routines 
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WHEN AN INTERRUPTION OCCURS: TASK MONTIOR RF^JijCriT SU>^uKVlS': ■!< INTERFACE 



TASK 



/ 



OVPSW 



Irttsrrupfian 










TIC 



TIC 

Resident supervisor's task 
interruption control routine 
(1) creates old VPSW from 
PSW and conditions at 
Interruption time, (2) stores 
it in ISA^ (3) fetches new 
VPSW for interruption type 
from ISA, (4) loads new 
VPSW, giving control to 
appropriate interruption 
processor. 



ISA 



Old VPSW 
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New VPSW 
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INTEPR"PTI<^N PRnrE^SING- AN OVERVIEW 
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interrupted 

program 



H THE INTERRUPTION PROCESSORS 



These requests for services require inmediate dispatching: 

1. Page or segment relocation request. 

2. Explicit dynamic linkage (DLINK SVC). 

3. Delete (DELET), ENTER, PCS, and restore privilege (RSPRV) SVCs. 

4. The resident supervisor's external interruption processor, CZCHC (can be either 
queued or dispatched immediately). 

5. Synchronous I/O handler (these routines check to see if a user-written routine 
exists; if one does, the request is queuedj otherwise the handler is dispatched 
immediately) . 

6. An interruption during VSS operation (unless there has beeen a relocation request). 

7. A paging error (unless VSS is in operation). 

When a routine is dispatched directly from an interruption processor, it returns to 
that processor. When further servicing is required, a branch is taken to QLEj otherwise 
exit is to the SCAN entry of the scanner /dispatcher, or to the standard optimal procedure 
(SOP) subroutine of the scanner/dispatcher if there was no long save in the ISA. On an 
exit to SCAN, the scanner's save area will contain the old VPSW of the interrupted rou- 
tine and the contents of the general registers at the time of the interruption. 



A SIMPLIFIED VIEW OF THE INTERRUPTION TABLE 
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QUEUING PROCEDURE 

Q LE receives control from the task monitor's interruption processors when the appropriate interruption handler does not require an immediate dispatch^ or from 
a handling routine to dispatch (1) a user-specified routine, (2) another handling routine, or (3) Itself at a later time. 
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ENTERING, LEAVING, AND RESTORING PRIVILEGE (I) 
Type -II Linkage 
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PRIVILEGED CALLED 
ROUTINE 



■r-^Bm^; 



Privileged routine 
returns to CZCJER 
in enter subroutine 
of SVC Interruption 
processor 



ft 



:4^ 






as 



ENTERING, LEAVING, AND RESTORING PRIVILEGE (n) 
Type - ni Linkage 



PRIVILEGED CALLER 
gives control to 
leave privilege 
routine via type-I 
linkage (BASR).(This 
routine must have 
been called by type- 
n linkage) 



LEAVE PRIVILEGE 

saves caller's save area and ISA long save 
area I and creates save area for called 
routine — it puts an address in called routine's 
return register that will cause restore 
privilege (RSPRV) SVC to be issued. 



SVC INTERRUPTION PROCESSOR 



RSPRV routine 

RSPRV restores save areas 
and returns to privileged 
calling routine. 



NONPRIVILEGED 
CALLED ROUTINE 



When RSPRV SVC is 
issued, control is 
passed to task 
monitor's SVC 
processor. 



THE SCANNER/DISPATCHER 

A QE represents a need by a task for the dispatch of an interruption handling routine. 
The RE and the ICB hold information about that routine. The scanner/dispatcher searches 
for the highest priority RE that has a QE attached to it. This is the highest active 
request entry (HJy^)^ and it will be dispatched. 

If the scanner/ dispatcher receives control bjefcre the interruption handling routine 
that was last dispatched has completed processing, that routine is referred to as the 
current active request entry (CAREL- If there is no RE with a higher priority than CARE, 
the scanner/dispatcher will return to the CARE. All active REs are considered for 
dispatch. 

Inhibitinci Interruptions ; A nonprivileged interruption handling routine may prevent the 
scanner/dispatcher from giving control to any other nonprivileged interruption handling 
routine until the first has completed its processing. It does this by setting the ILL— 
flag in the ISA and the intfirru^i4Dna_disabled flag in the RE. When these flags have 
been set, no other interruption handler in the ITB will be dispatched unless it is 
privileged. 

The task monitor may still receive interruptions, dispatch those requirii^ immediate 
dispatch, and queue those whose dispatch is to be deferred; these must wait for the com- 
pletion of the interruption that has the 01 bit set. An interruption handling routine 
could be entered for an interruption while it is still processing a previous interrup- 
tion, thus losing the first processing. Recursive routines, which call themselves, must 
protect themselves in this way. 

Wh^i the interruption handling routine has finished its processing, it returns control 
either to (1) the privileged return point in the scanner/dispatcher or (2) if it is non- 
privileged, to the RSPRV routine in the task monitor's SVC processor, which returns con- 

^ trol to the scanner/ dispatcher at the nonprivileged return point. 
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1^ AN EXAMPLE OF TASK MONITOR INTERRUPTION PROCESSING 

A programmer, writing PROGRAMA foresees the possibility of program interruption 8 
occurring at a point where he does not want PROGRAMA to lose control. He writes a rou- 
tine that will correct the fixed-point overflow condition that causes program interrup- 
tion 8, To insure the execution of his routine as an interruption handler, he needs an 
ICB and an RE- 

To provide the ICB, he issues a SPEC macro instructioni using the parameters given, 
SPEC creates an ICB- The ICB contains the interruption handling routine's entry point, 
the address of a communications area provided by the programmer, and the type of inter- 
ruption to be handled. These are generated as declared constants. 

PROGRAMA must then issue a SIR macro instruction, which gives control to the SIR rou- 
tine, which builds the RE and returns to PROGRAMA. 

PROGRAMA continues execution. The foreseen possibility occurs j PROGRAMA is inter- 
rupted for a fixed-point overflow error. The resident supervisor transfers control to 
the task monitor's program interruption processor. 

The interaruption processor then diagnoses the condition as a non-relocation program 
interruption in the nonprivileged state, and branches to the task monitor's queue linkage 
entry routine (QLE). 

QLE finds the request entry built by SIR for this interruption. It then builds a QE 
containing the interruption conditions and attaches it to the RE- This indicates that 
the interruption has occurred and activates the RE. QLE then branches back to the pro- 
gram interruption processor, which branches to SCAN. 

Eventually, SCAN issues an LVPSW instruction to transfer control to PROGRAMA' s inter- 
ruption handling routine, which, when it has completed processing, returns control to 
SCAN, which eventually executes an LVPSW to return control to PROGRAMA, 
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SIR PROCESSING— LINKAGE CONVENTIONS IN ACTION 

In the previous example, PROGRAMA issues a SIR macro instruction to build a request 
entry. Since PROGRAMA is nonprivileged, the expansion of SIR must generate an ENTER SVC 
to implement type- II linkage to SIR. 

The execution of an ENTER SVC causes the resident supervisor to transfer control to 
the task monitor's SVC interruption processor. 

The enter routine in the SVC interruption processor sets up the entry point address, 
rettirn address, and save area for the linkage, and dispatches via a load VPSW instruc- 
tion. The resident supervisor then passes control to the SIR routine. 

The privileged SIR routine, using the ICB and the priority for the interruption hand- 
ling routine (both of which are parameters of the SIR macro), builds the RE for program 
interruption 8, and attaches it to the program device entry. 

SIR returns to the enter routine, which restores machine conditions to what they were 
when the enter routine received control, and exits to the task monitor 
scanner /dispatcher • 

SCAN will eventually issue the appropriate LVPSW instruction, and the resident super- 
visor will return control to PROGRAMA. 
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USER-SPECIFIED INTERRUPTION HANDLING 
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PROGRiyd ORGANIZATION 



Program Interiniptiion Processor 

Entry Point ; CZCJTPi the resident supervisor will pass control to this 
point via an L¥PSW instruction. 

Operation ; This routine first checks to see if ¥SS was in effect at the 
time of the interruption. If it was, and if the interruption code is 
for a page or segment relocation exception, and if the interruption did 
not occur during explicit linkage, processing continues at TPIDLX, 
described below. If all three conditions are not met, exit is to CZHNP, 
the VSS program interruption routine. 

When VSS was not in effect at the time of an interruption for page or 
segment relocation, processing continues at TPIDLX. For any other type 
of program interruption, this routine checks to see if the interruption 
came from within the task monitor. 

• Second occurrence of expected interruption in task monitor - Exit is 
to the ABEND routine. 

On the first occurrence, if the ¥SS flag was set before the interrup- 
tion, exit is to CZHVN, the ¥SS activation routine. Otherwise the 
"interruption expected" flag is turned off and control is returned to 
the point of interruption at TMPIREC. 

If this was not a task monitor interruption, and the interrupted task 
was nonprivileged, QLE is called at TMPOl to create a queue entry for 
processing of the interruption, and exit is to the standaxd ogtimal pro- 

cedure^subroutine of the task monitor's interruption processors."" 

If the interrupted routine is privileged, and the interruption code 
is greater than 32, a check is made to see if an asynchronous program 
interruption is permissible. If not: 

• Program interruption in privileged state with code greater than 32 - 
At TMP258 the SYSER macro instruction is issued Cunless the code is 
202) , and exit is to the ABEND routine. 

If so, an asynchronous interruption code table is searched. If it con- 
tains a code, processing resimies at TMPOl i if not, processing continues 
at TMP258. 

If the interrupted routine is privileged, if the interruption code is 
less than 32 and if the interruption occurred in PCS^ processii^ resumes 
at TMPOl. If the interruption occurred in the task monitor, the "task 
monitor interruption expected" flag is turned off, and control is 
returned to the interrupted routine. 

• Program interruption in privileged state with code less than 32 
caused by neither the task monitor nor PCS - The SYSER macro 
instruction is issued, and exit is to ABEND. 

Interruption Code 16 or 17 — First Relocation Request 

At TPIDL, the ISA flag will be referenced to determine whether the 
interruption occurred in the virtual momory input error recovery routine 
CVMIER) . 

• Interruption in VMIER - SYSER is issued and exit is to ABEND. 

This routine will then make a long save and pass control to the dynamic 
loader via an I,VPSW instruction. On return, if the second implicit 
dynamic linkage (or relocation request) flag is on the ISA, control will 
be given again to the dynamic loader. If the flag is not on, exit will 
be to SCAN in the scanner/dispatcher. However, if VSS is in effect when 
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the interruption occurs, exit will be to the ¥SS activate interruption 
processor. 

Second Relocation Recpiest 

When the flag indicating this condition is on in the pushdown save 
area after the test for VMIER is made, the second implicit dynamic link- 
age flag will be turned on in the ISA and control will be returned to 
the task. 

Third Relocation Request 

Two is the maximum number of relocation requests allowed by the 
system. 

• Third request - The SYSER macro is issued, and exit is to ABEND. 

Routines Called : QLE CCZCJQS), dynamic loader CCZCDL4). 

Exits : VSS program interruption processor CCZHNPA) , ¥SS activate inter- 
ruption processor CCZHN¥A) , SOP, SCAN, ABEND, and retuim. 

SVC Interruption Processor 

Entry Point ; CZCJTSj used by the resident supervisor. 

Operation ; When the interruption occurs during ¥SS operation, exit will 
be to CZHN¥, the ¥SS activate interruption processor. For an S¥C great- 
er than 127 or less than 116, issued by a nonprivileged routine, QLE 
will be called to queue a linkage entry on the S¥C device entry. Exit 
is then to SOP. 

• S¥C greater than 127 or less than 116 issued by a privileged routine 
- SYSER will be issued at TMSEE, which will give control to CEAIS, 
the system error processor. When CEAIS returns control, the task 
will be terminated by ABEND. 

When the S¥C code is between 116 and 127, a branch to the appropriate 
section of the S¥C interruption processor will be taken: 

S¥C 116 - EXIT 

S¥C 118 - CLIP C pause) 

S¥C 119 - CLIC (command) ; This routine will check for this error: 

• old ¥PSW privileged - Processing continues at TMSSE. 

otherwise, QLE is called to queue a linkage entry on the command sys- 
tem's user control routine to process the CLIP, CLIC, or EXIT macro 
instructions^ exit is to SOP. 

SVC 117 - RAE : The restore and enable S¥C causes a long save in the 
scanner's save area and in the ISA save area 1 or 2, depending on lAie- 
ther the routine is nonprivileged or privileged. It then exits to SCAN. 

S¥C 120 - RSPR¥ ; Restore privilege will check for the following error: 

• old VPSW privileged - Processing continues at IMSSE. 

Usually processing begins at this routine's second entry point, CZCJR2 
(forced return). This entry is used by enter and cleanup when the P3 
flag is on. This flag indicates a type- III linkage and means that the 
task is noninterruptable. Restore privilege is used to restore that 
task to its original status. If the pushdown pointer in the ISA is 
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zero, this routine branches to QLE. QUE causes linkage to CZAMl, the 
comraand system's user control routine. On return from QLE, exit is to 
SOP. Otherwise, when type-Ill linkage is not in effect, this routine 
exits to the nonprivileged rettirn point in the scanner/dispatcher. If 
type- III linkage is in effect, FREEMAIN is used to return the storage 
used for the nonprivileged save area, the P3 flag is turned off, and 
this routine returns to the privileged caller, via a load VPSW 
instruction, 

SVC 121 - ENTER ; The ENTER SVC routine first performs the following 
test: 

• Old VPSW privileged - Processing resumes at TMSSE. If the old VPSW 
is nonprivileged, the enter code is tested for validity. 

• Invalid enter code - QLE is called at TMSE9 to queue a linkage entry 
on the program interruption device entry. The P3 flag is then 
tested. If it is on it indicates a type-Ill linkage with no inter- 
ruptions permitted, and control is given the RSPRV SVC routine, 
otherwise, exit is to SOP. 

When the enter code is valid and the P3 flag is set, the privileged 
force/shutdown flag is inspected. If it is set, a long save is done in 
the privileged save area and the force flag is set. If not, a long save 
is done in the ISA save area 1. The linkage parameters are adjusted and 
moved to the VPSW. When the force/shutdown flag is on it is turned off, 
and the return parameters are set so control will return to CZCXTER. The 
appropriate routine is then entered via a load VPSW instruction. 

If the P3 flag is not on, but the routine is not interruptable any- 
way, processing is the same as if the P3 flag were on, except that the 
force/shutdown flag is not tested. The long save is done in the ISA 
save area 1. 

When the routine is interruptable, an interruption code of 60 is 
placed in the VPSW, and processing resumes at TMSE9. 

The routine that is entered must return to CZCJER. At that point, 
task interruptions are disabled. When the cleanup flag is on, exit is 
to the cleanup routine (CZCJC). Otherwise, the ISA save area 1 is moved 
to the scanner save area and exit is to SCAN. 

SVC 122 - RTRN ; The RETURN SVC routine first checks for the following 
error: 

• old VPSW privileged - Processing resumes at TMSSE- 

The RETURN SVC is placed in the old VPSW, and this routine branches to 
the task monitor's cleanup routine. On return from cleanup QLE causes a 
linkage entry to be queued on the command system's user control routine, 
and exit is to SOP. 

SVC 123 - DELETE : This routine sets the explicit dynamic linkage flag 
in the pushdown save area and dispatches to the dynamic loader's delete 
routine via a load VPSW. On return from delete the dynamic linkage flag 
in the ISA and the explicit dynamic linkage flag in the pushdown save 
area are turned off. Exit is to SCAN. 

SVC 125 - PCS CALL : The PCS CALL SVC routine first checks the privilege 
flag in the ISA. 

• Privileged caller - Processing continues at TMSSE. 

This routine then dispatches to the program control system via a load 
VPSW instruction. On return from PCS, the ITI macro instruction is 
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issued to inhibit task interruptions, the VPSW is set nonprivileged, and 
exit is to SCAN. 

S¥C 127 - DLINK (load and call) : The DLINK SVC causes a long save in 
either the task monitor's save area 1 or 2, depending on whether the 
task is nonprivileged or privileged. This routine then dispatches to 
the dynamic loader via a load VPSW instruction. On return from the 

dynamic loader the ITI macro instruction is issued to disable interrup- 
tions. If the request was for a call, the V-con for the routine to be 
called is placed in register 15, and the R-con in the calling program's 
save area. Exit is to SCAN. 

Routines Called : Queue linkage entry CCZCJQS) , cleanup CCZCJC) , dynamic 
loader (explicit link) CCZCDL) , dynamic loader (delete) (CZCDU). 

Exits: SCAN, SOP, scanner/dispatcher (TMRETNP) , VSS activate interrup- 
tion processor (CZHNVB) . 

Timer Interruption Processor 

Entry Point ; CZCJTT. It is used by the resident supervisor. 

Operation : 

Initial Processing — This routine first tests a flag in the ISA to 
see if VSS was in operation at the time of the interruption. If it was, 
exit is to CZHNVD. Otherwise the interruption is logged. The interrup- 
tion code passed in the VPSW is then tested for validity — code 1 for a 
real time interruption, and code 2 for a task time interruption. 

• Invalid code - the SITSER macro instruction is issued for an invalid 
timer interruption code, QLE is called to queue a linkage eitry on 
GATWR, and exit is to SOP. 

Real Time Interruption Processing — The value in the timer that 
caused the interruption should equal the value used in the set timer 
(SETTR) macro instruction. If so, and the clock was not canceled, and 
the ignore indicator is not on, QLE queues a linkage entry for the real 
time interruption, and the clock is set inactive. When there are no 
more timers to set, exit is to SOP. 

• canceled clock - In this case this routine goes through a loop at 
TTR6 to determine if there are any other timers to be set. If there 
are not, exit is to SOP. 

• More timers to be set - The SETTR macro is issued and when the time 
limit has not passed, exit is to SOP. When it has, QLE is again 
called and the loop at TTR6 is executed. 

• Ignore indicator on - SETTR is issued. When the time limit has not 
passed exit is to SOPj when it has, QLE is called and the loop at 
TTR6 is executed. 

• No active timers - If the value received matches the value used in 
SETTR, exit is to SOP. 

• Timer value received does not match SETTR value - The SYSER macro 
instruction is issued for an invalid real time interruption. This 
routine then branches to QLE in order to write the error message via 
GATWR. Exit is to SOP. 

• System timer limit reached - After SETTR is issued if the system 
timer limit for real-time interruptions has been reached, this rou- 
tine branches to QLE to queue a linkage entry on the program inter- 
ruption device entry. Exit is to SOP. 
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Task Tigfe Interruption — The timer value received should match the 
accumulated task time. If so, and if the clock is not cancelled, the 
ignore indicator is not on, and the interrupted clock is not task clock 
15, this routine branches to QIjE for the timer interruption and the 
clock is set inactive. If there are no more timers to set, exit is to 
SOP. 

• Clock was canceled - When there are no more timers to set and the 
clock is not task clock 15, exit is to SOP. If the clock is task 
clock 15, exit is to the forced return point in the SVC interruption 
processor, CZCJR2. This is the second entry point in the restore 
privilege routine (SVC 120) • 

• Ignore indicator on - When the ignore indicator is on, processing 
resumes at TTT7A. The XTRTM macro instruction is issued to compute 
the task's accumulated CPU time. If the task has one milliseoDnd or 
more to run, the SETTU macro instruction is used to update the 
user's timer. When the clock is task clock 15, exit is to CZCJR2; 
otherwise, exit is to SOP. If the task does not have at least one 
millisecond to run, QLE queues a linkage entry for the timer inter- 
ruption, the clock is set inactive, and if there are no more timers 
to set, exit is to SOP, or for clock 15, to CZCJR2. 

• Task clock 15 - In this case, clock 15 is canceled. If the asynch- 
ronous timer indicator is on in the prefixed storage area, it is 
changed to indicate clock 15 exit. If there are no more timers to 
be set, exit is to CZCJR2. 

• More timers to be set - A loop is entered at TTT6 to determine which 
clocks need to be set. Processing then begins at TT7A as described 
above. 

• Timer value received does not match accumulated task time - The 
SYSER macro instruction is issued for an invalid task time interrup- 
tion. Exit is to ABEND. 

Routines Called ; QLE CCZJQS). 

Exits: SOP, SCAN, VSS activate interruption routine (CZHNVD), RSPRV SVC 
(SVC interruption processor) , ABEND. 

External Interruption Processor 

Entry Point ; CZCJTX. It is used by the resident supervisor. When the 
task initiation flag in the ISA is not on, the task monitor's asynch- 
ronous interruption processor also branches to this point. 

Operation ; When VSS is in operation at the time of the interruption, 
this routine exits to the VSS external interruption processor, (CZHNE) . 
If the task is logged on or was in the process of logging on when inter- 
rupted, a message code is placed in the old VPSW, and this routine links 
to the command system external interruption processor (CZAHC) . If the 
return code from that module is not zero, exit is to SOP. Otherwise, 
QLE is used to queue a linkage entry on the external interruption device 
entry before that exit is taken. 

When the task is not logged on or in the process of logging on, this 
routine processes the interruption as a logon. The logon in progress 
flag in the ISA is turned on, interruptions are permitted, and the VPSW 
is set nonprivileged. If the interruption was initially received as an 
asynchronous interruption, QLE is called to queue a linkage entry to the 
initial attention interruption processor, CZAHB, and exit is to SOP. 
Otherwise, processing continues as if the task were already logged on. 
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Routines Called ; Queue linkage entry (CZCJQS) , connnand system external 
interruption processor (CZAHC) . 

Exits ; VSS external interruption processor CCZHNE), SOP. 

Synchronous I/O Interruption Processor 

Entry Point ; CZCJTI, It is used by the resident supervisor. 

Operation ; If VSS was in operation when the interruption occurred, this 
routine exits to CZHSB, the ¥SS synchronous I/O interruption processor. 
Otherwise, the interruption is logged, and QLE is called to queue a 
linkage entry on the synchronous I/O interruption device. This module 
then branches to the appropriate I/O posting routine. On return from 
the posting routine, exit is to SOP. 

Routines Called ; Queue linkage entry CCZCJQS) , I/O posting routine. 

Exits ; VSS I/O interruption processor CCZHSB) , SOP. 

Asynchronous I/O Interruption Processor 

Entry Point ; CZCJTA. It is used by the resident supervisor. 

Operation ; When VSS is operating at the time of the interruption this 
routine exits to CZHNV (VSS activate interruption processor) . Other- 
wise, the interruption is logged and the task initiation flag in the ISA 
is tested. If it is on, this routine branches to QLE to queue a linkage 
entry on the asynchronous interruption device entry, and exit is to SOP. 

When the task initiation flag is off, and logon is not in progress, 
the asynchronous logon flag is turned on and this routine exits to the 
task monitor's external interruption processor, CZCJTX. 

When logon is in progress, the interruption is ignored and this rou- 
tine returns control to the calling program via an LVPSW instruction - 

Routines Called ; Queue linkage entry CCZCJQS) . 

Exits ; VSS activate interruption processor CCZHNVC), SOP, task monitor 
external interruption processor (CZCJTX) , return. 

Data Set Paging Interruption Processor 

Entry Point ; CZCJTY. It is used by the r^ident supervisor. 

Operation ; If VSS was in effect when the interruption occurred, this 
routine exits to CZHNV, the VSS activate interruption processor. Other- 
wise, the interruption is logged, and a flag in the ISA is tested to see 
if the interruption occurred during error recovery for a previous data 
set paging error. If so, the SYSER macro instruction is issued and exit 
is to ABEND. If not, this routine branches to the virtual memory input 
error recovery routine (VMIER). On retiirn from VMIER, exit is a return 
to the calling program via an LVPSW instruction. 

Routines Called ; Virtual memory input error recovery CCZCEIl) . 

Exits: VSS activate interruption processor (CZHNV), return, ABEND. 

Virtual Support System Interruption Processor 

Entry Point ; CZCJTV. It is used by the resident supervisor. 
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operation ; This routine first logs the interruption, and then tests a 
flag in the ISA to determine if the old VPSW was masked, indicating that 
interruptions were not permitted. When the flag is set and the implicit 
dynamic linkage flag is on, or if the interruption occurred in the task 
monitor's front end, the VSS interruption flag is turned on in the push- 
down save area and the routine returns via a load ¥PSW instruction. 
Otherwise, this routine exits to the VSS activate interruption proces- 
sor, CZHNV. 

Routines Called ; None. 

Exits; VSS activate interruption processor CCZHNVA) , return. 

Standard Optimal Procedure Subroutine (SOP) 

Operation ; When the VPSW is privileged, the force/shutdown flag is 
tested. If it is not on, the registers are restored at SOPSROl and this 
routine returns to the last^,^.^ijatjexr-UB,ted routine via a load VPSW instruc- 
tion. If the force/shutdown flag is on, it is' turned off. If task 
initiation is not over, processing continues at SOPSROl. Otherwise the 
dynamic loader and P3 flags are turned off, and ABEND is called via the 
task monitor's ENTER SVC processor. 

When the vPSW is nonprivileged and this routine was given control by 
a task monitor interruption processor, the force/shutdown flag is again 
tested- If it is on, it is turned off. If it is off, or if the P3 flag 
is off, this routine exits to SCJysi. Otherwise, the P3 flag and the 
enter flag are turned off and exit is to SCAN. 

Routines Called ; None . 

Exits ; ABEND, SCAN, return. 

Queue Linkage Entry Routine 

Entry Point ; CZCJQS. QLE is entered via type-I linkage. 

Operation ; Upon entrance to QLE, task interruptions are inhibited. The 
queue index is tested. When it is less than 6, this routine branches to 
one of the standard queue processors. When it is between 6 and 10, the 
QLE PREBUILT subroutine is used to chain a QEL to a prebuilt REL, and 
exit is to the COM subroutine. 

• Queue index greater than 10 - The SYSER macro instruction is issued 
and this routine branches to the COM subroutine. 

SYNCHQE ; This section of QLE, entered to process synchronous I/O queue 
entries, first branches to the SDATCHCK subroutine to convert the sym- 
bolic device address into the correct SDAT entry. When that is done, 
this routine checks the existence of a synchronous I/O device entry 
matching the SDAT. 

• No synchronous DE - Exit is by means of QLE RET subroutine. 

When there is a synchronous DE, a check is made for a nonzero RE that 
has not been deleted. When one is found, the CKICB subroutine is called 
to determine if the ICB is addressable. If it is not, the test for a 
valid RE continues. When the RE is valid, a check is made to see if its 
SDAT matches the SDAT of the interrupted routine. If there is a match, 
the ITGETMN subroutine is called to make sure the ITB can accommodate 
another entry, and when ITGETMN returns, the BLDLBQE subroutine is 
called to build the common areas of a QE. The status and sense bytes 
peculiar to this QE are moved in and exit is to COM. 
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• No aetiire RE matching interruption RE - Exit is to the RET 
subroutine. 

PROGQE ; At PRELOP, if there is a program interruption RE whose ICB is 
addressable and contains an interruption code which matches the inter- 
ruption code in the ISA, and it has not been deleted, and there is a 

V-con for the interruption routine and a COMAREA, this routine checks to 

see if the interruption occurred in PCS, If it did not, and there is no 
CARE, or the priority of this RE is greater than that of the CARE, and 
the P3 flag is off, then the ITGETBM subroutine is used to guarantee 
that the ITB has enough main storage. The QE is built and added to the 
chain of this RE. Hie Ul flag in the ISA is turned off, and exit is to 
the COM subroutine. 

• No Hiatching REs - The P3 flag, which indicates a type-Ill linkage 
with no interruptions allowed, is tested at PDIAG. When it is on, 
the forced return switch is turned on before a branch to the DIAGNO 
section of the PREBUILT subroutine is taken. This code builds a QEL 
for DIAGNO CCZAHAl). When the forced return switch has been turned 
on, an error code of X'66' is placed in the VPSW and it is moved to 
the QEL. The Ul flag is then turned off, and exit is to the COM 
subroutine . 

• The ICB and ISA interruption codes don't match - 

• RE was deleted - 

• No ¥-con for interrupted routine - 

• No COMAREA - In these cases the pointer to the RE is obtained and 
the next RE is tested against these conditions at PRELOP. 

• The interruption occurred in PCS - The P3 flag is not tested before 
the branch to ITGETMN at BLDQE. 

• The CARE has priority higher than this RE - Processing resumes at 
PDIAG. 

• The P3 flag is on at P3CHK - Processing is the same as that under 
the same condition at PDIAG. 

SVCQE ; This routine searches the request entries on the SVC device 
entry until it finds one which has an addressable ICB with an S¥C code 
matching the code in the ISA. The P3 flag is then tested. If it is not 
on the ITGETMN subroutine is called to make sure there is oiough space 
for another ITB entry, and exit is to the BLDNQE subroutine. 

• P3 flag on - Processing continues at TOFRT2. The forced return 
switch is turned on and the DIAGNO section of the PREBUILT siibrou- 
tine receives control to build a QEL for DIAGNO (CZCHA). The forced 
return flag is then tested. If it is on, a X*67* error code is 
placed in the VPSW. If it is off, a X*62* error code is placed in 
the VPSW. The VPSW is then moved to the QE and exit is to the COM 
subroutine. 

• No matching RE found - The P3 flag is tested at PDIAGS. Processing 
continues at TOFRT2. If the P3 flag is not on, the forced return 
flag is not turned on. 

EXTQE ; If an RE can be found that has an addressable ICB and the RE 
contains a message number that matches the message number in the ICB and 
the RE was not deleted, this routine branches to the ITGETMN subroutine. 
On return from ITGETMN, control is given to BLDLEQE to build the QE. 
This routine then branches to the GETMAIN (byte) routine (CZCH2} , at 
GETMSGMN in order to get main storage for the MCB and associated message 
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text. A pointer to the MCB is then placed in the QE, and exit is to 
COM, 

• No suitable RE found - The DIAGNO section of the PREBUII.T subroutine 
receives control in order to build a QEL for XMIS (CZAHDS), the com- 
mand system external interruption message routine. Processing con- 
tinues at GETMSGMN. 

ASYNQE: This routine branches to the SDATCHK subroutine to convert the 
symbolic device address into the proper format for a SDAT entry. This 
routine then branches to ITGETMN, and on return, builds a QE for this 
interruption. 

• Interruption from. SYSIN - This routine checks whether the system or 
a user will handle this interruption. If the system will receive 
the interruption the attention counter is incremented. Exit is to 
the COM subroutine. 

If there is any asynchronous device entry matching this SDAT, and an RE 
queued on the DE whose ICB is addressable and contains an interruption 
code that matches the code placed in the QE, exit is to COM. 

• No watching DE - 

• No matching RE - 

• Request entry deleted - Under any of these conditions the QE is 
cleared and returned to the available chain. Exit is to the RET 
subroutine. 

• ICB not addressable - The search for an acceptable RE continues. 

• No matching SDA and SDAT - The SYSER macro is issued and exit is to 
ABEND. 

TIMQE : When there is a timer RE whose ICB is addressable and contains 
the timer type and number matching those of the interrupted timer, and 
if that RE has not been deleted, the ITGETMN subroutine is used to make 
sure the ITB has enough main storage. The timer type is then placed in 
the QE, and exit is to the BLDNQE subroutine. 

• No matching RE - The SYSER macro is issued, and exit is to ABEND. 

QLE Subroutines 

PREBUILT ; The message control block contains data used in building a 
QEL. This subroutine first gets a pointer to the MCB for the necessary 
data. At DIAGNO, it uses ITGETMN and BLDLEQE to insure that there is 
storage for the QE and to initialize it. If this is a logon linkage 
entry, the address of the SDAT pointer is placed in the QE, the linkage 
to the initial attention interruption processor (CZAHBl) is set up, and 
exit is to COM. If it is not a logon linkage entry the QE is finished, 
and this subroutine returns to its caller. 

SDATCHCK ; When the symbolic device address is zero, this subroutine 
returns control to the calling portion of QLE. Otherwise it multiplies 
the address by 6*1 and adds it to the starting address of the SDAT to get 
the address of the correct SDAT entry. If the device is detached or 
partitioned, the entry is invalid and the SYSER macro is issued. Exit 
is to ABEND. Otherwise, exit is a return to the calling section of QLE. 

ITGETMN ; This subroutine first checks to see that all entries in the 
ITB have been filled. If they have not, the registers are restored and 
control is returned to the branch point. The GETMAIN (page) routine, 
CZCG2, then receives control to get the required pages of main storage- 
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The pointers to the available pages are adjusted and control is retiirned 
to the branch point. 

BLDNQE ; This subroutine places the interruption code, VPSW pointer, and 
device type in the QE and returns to the branch point. 

BLDLEQE ; This subroutine places the LE code and interruption code in 
the QEL, and then tests to see if the QEL is for a prebuilt routine. If 
it is, the device type is added to the QEL before the return to the 
branch point. 

COM ; If the RE is active, the QE is queued on it at QUEUE and a test is 
made for a forced return. If the forced return flag is off, this rou- 
tine exits to the RET subroutine at RESMSK. If the forced return flag 
is on, control is returned to the forced return point in the task mon- 
itor's SVC processor, CZCJR2. 

• RE inactive - The active code is set in the RE. When there are no 
active REs on the chain, this RE becomes the highest active CHARE) . 
Processing resumes at QUEUE. When there are other REs and this RE 
is lower in priority than the HARE, it is merely placed on the RE 
chain. If it is higher in priority than the HARE, it becomes the 
HARE. In either case, processing resumes at QUEUE. 

RET: This subroutine first zeroes the return code. At RESMSK, if a QE 
was queued, the interruption was an asynchronous attention, and the P3 
flag is on, this subroutine branches to the task monitor's set clock 
routine to set clock 15 at 100 milliseconds to allow attention interrup- 
tions. Then at RISMSKG, interruptions are allowed if they were inhib- 
ited before, the registers are restored, and this routine restores con- 
trol to the routine that called QLE. 

• No QEs queued - 

• Interruption was not an asynchronous attention - 

• P3 flag was not on - under any of these conditions, set clock is not 
called and processing continues at RESMSKG. 

CKICB ; This subroutine performs a null operation (one that has no net 
result) on both the first and last bytes of the ICB. It then checks to 
see if a program interruption 5 (addressing) or 6 (specification) was 
received. If not, the ICB is addressable and control is returned to the 
branch point within QLE. 

• ICB not addressable - The RE is deleted. If there are QEs on this 
RE the task is aborted j otherwise, control is returned to the branch 
point with a return code of 4. 

Routines Called ; GETMAIN (page) (CZCG2) , set clock (CZCJY) . 

Exits : ABEND, SVC interruption processor (CZCJR2) , return- 

Scanner/Dispatcher 

Entry Point ; SCAN. This entry is used only by other task monitor rou- 
tines. There are also two return entry points; TMRETNP for nonprivi- 
leged routines, and SYSPRT for privileged routines. 

Operation ; The scanner/ dispatcher receives control to dispatch the 
highest priority active request entry — HARE. It is given a pointer to 
the task monitor's PSECT, from which it obtains pointers to the other 
control blocks it uses. The scanner /dispatcher first checks for several 
conditions which inhibit its processing: 
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• QE coiint is zero - No RE is active , so control is returned to the 
interrupted routine, 

• HARE=CARE - Highest active routine is currently processing, so con- 
trol is returned to the interrupted routine, 

• No QE on HARE corresponds to the ICB - The QEs are removed and the 
RE is deactivated. The next highest RE becomes HARE and processing 
starts again at SCAN. 

• The COMAREA pointer Cor the entry point 1 pointer for a nonsystem 
routine) is missing - Control is returned to the last interrupted 
routine. 

• The P3 or Ul flag is on - The interirupted routine was processing 
under type-Ill linkage, and should not be interrupted, so control is 
returned to it. 

• The interrupted routine was privileged - Control is returned to it. 

Scanner/dispatcher processing then begins. The scanner save area in 
the TMPSECT is moved to either the privileged pushdown save area (PDSA) 
for a privileged routine, or to the nonprivileged PDSA for a nonprivi- 
leged routine. HARE becomes CARE, and the old CARE is rechained by 
priority on the active RE queue, and must wait until it is again the 
highest active request entry to complete its processing. Processing for 
an L-type QE (one that requests the services of a system interruption 
handling routine) continues at SCANLE. If the QE is for a user-written 
routine, the existence of a user-written communications area (COMAREA) 
is checked for at SCANQE. 

• No COMAREA for privileged CARE - A SYSER macro instruction is 
issued, and exit is to ABEND. 

• No COMAREA for nonprivileged CARE - At JTC0M2, QLE is called for 
DIAGNO, to inform the user of his error. At DEQ the QE is deleted, 
and the currently-processing interruption handling routine is 
dispatched. 

Then, at JTCOM, if the CARE is nonprivileged, the CKCLS macro 
instruction is issued to make sure that the COMAREA is also 
nonprivileged. 

• Privileged COMAREA or ICB EP1=0 for nonprivileged CARE - Processing 
continues as above at JTCOM2. 

When the COMAREA and CARE match and the proper ICB entry point point- 
er is present, a check is made at SCANQEl to see if the QE is external. 
If so, the message in the MCB must be moved to a user- specif ied area. 

• User-specified message area has incorrect privilege - The message is 
moved into an area provided by the task monitor. 

Information about the message is then placed in the CX)MAREA. 

At DEQ, the QE is removed from the QE chain. If CARE is privileged, 
the appropriate flags are set and processing resumes at CHKSWO. Other- 
wise, if interruptions are inhibited, the Ul flag is turned on. Then 
the VPSW is flagged nonprivileged and one is added to the counter of 
dispatched nonprivileged routines. If the ICB entry point 2 pointer is 
not zero, processing resumes at EP2NZ. 

At CHKSWO, the currently processing interruption handling routine is 
dispatched. 
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At EP2NZ, if the pushdown save area pointer is zero, the currently 
processing interruption handling routine is dispatched. 

At SCANLE, if the requested system interruption handling routine is 
DIAGNO, special DIAGNO inf orination is placed in the QE, Other system 
information is placed in the QE and processing continues at DEQ. 

When an interruption handling routine completes its processing, it 

returns control to the scanner/dispatcher at either SYSPRT or TMRETNP, 
depending upon whether it was privileged or nonprivileged. 

At SYSPRT, task interruptions are inhibited, and the ISA save area 1 
is moved into the privileged pushdown save area. Processing continues 
at DELCHK. 

At TMRETNP, the pushdown save area is moved into the ISA save area !• 
If the counter of nonprivileged interrupted routines dispatched is not 
greater than zero, processing continues at DEItCHK. Otherwise, one is 
subtracted from the counter, and the addressability of the ICB is 
checked. 

• User deleted the ICB for a returning interruption handling routine - 

Exit is to ABEND. 

If the ICB entry point 2 pointer is zero, processing continues at 
DELCHK. If not, it means that the task has issued an INTINQ macro 
instruction and relinquished control at this point. Should it be inter- 
rupted again, it will resume processing here. Information about this 
task is moved into the pushdown save area. Otherwise, processing infor- 
mation is moved into the pushdown save area. 

Then, at DELCHK, the following series of checks is performed: 

• RE not deleted - Processing continues at QECHK. 

• ICB not addressable - Exit is to ABEND. 

• DE code invalid - At INVTYP, exit is to ABEND. At QECHK, the checks 
continue. 

• HARE=CARE - Processing continues at CACHK. 

• No QEs on CARE - Next active RE becomes CARE and processing con- 
tinues at QECHK. 

If there are QEs on CARE, the CARE PDSA is moved to either the privi- 
leged or nonprivileged PDSA, depending upon the privilege of CARE. 
Then, if there are QEs on CARE, processing resumes at SCANIN. Other- 
wise, processing resumes at SCANR. 

At CACHK, if there are no QEs on CARE, processing continues at LOWER, 
otherwise, if the QE is L-type, processing resumes at SCANLE. If the QE 
is for a user-written routine, the CHKMCH subroutine is called to find a 
QE-ICB match. 

• No QE-ICB natch - Processing continues at CACHK. 

• COMAREA pointer = - 

• ICB EPl pointer = - Processing continues at GNACT. 

If the COMAREA pointer and ICB entry point 1 pointer contain nonzero 
values, processing continues at SCANQE. 
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M, LOWER, certain fields in the RE are zeroed. If CARE is not HARE, 
CARE is removed from the active RE chain. A search is then made for 
care's DE. If it cannot be found, the next highest priority active RE 
becomes CARE. When the CARE DE is found, it is flagged as active, and 
the CARE pointer in the interruption table is zeroed. 

Then, at GNACT, if there are more active REs, the next highest- 
priority RE becomes CARE and the following checks are performed: 

• RE not an insert - 

• RE is L-type - Processing continues at PUSHUP. 

• No QEs on this RE - Processing continues at LOWER. 

If there are no more active REs, processing continues at PUSHUP. 

If none of the bulleted conditions are true, the CHKMCH subroutine is 
called to find a QE-ICB match for this RE. 

• No QE-ICB match found - If there are no more QEs, processing con- 
tinues at LOWER; if there are, CHKMCH is called as above. 

At PUSHUP, the pushdown save area is moved to the scanner's save area. 

• Last RE dispatched - 

• RE not an insert - Control is returned to the interrupted routine. 

Otherwise processing continues with the fourth error check after 
entrance to the scanner/dispatcher. 

At SCANR, the following checks are performed: 

• CARE or first nonprivileged RE is on miscellaneous queue - Proces- 
sing continues at SETRENA. 

• Invalid DE code - Exit is to ABEND. 

The CARE DE is found and flagged active. At SETRENA, if HARE is 
CARE, the next highest priority active RE becomes HARE, and CARE is 
deactivated. 

At SCANIN, HARE becomes CARE. If the first QE on the new CARE is for 
a system routine, processing resumes at SCANLE. Otherwise, CHKMCH is 
called to find a QE-ICB natch. 

• No QE-ICB match found - Processing continues at LOWER. When the 
match is found, processing resumes at SCANQE. 

CHKMCH ; This subroutine first makes sure that the DE type is valid. 

• Invalid DE type - At INVTYP, exit is to ABEND. 

• No QEs on CARE - An error return code of 4 is set and control is 
returned to the branch point within the scanner/dispatcher. 

A branch is then taken according to DE type. Various checks are made 
depending on the DE type. 

Program ; The interruption codes in the QE and the ICB must match. 

Timer; The task or real codes must match, and the timer codes must also 
match . 
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SVC ; The SVC codes must match. 

External ; The message codes must match. 

Asynchronous ; The attention codes must match. 

Synchronous ; A match is assumed. 

If the match has been found, a successful return code is placed in 
register 15 and control is returned to the branch point. 

If no match is found, any QEs tested are zeroed and their space is 
flagged available. The error return code of ^ is placed in register 15 
and control is returned to the branch point. 

Scanner/Dispatcher Routines Called ; None- 

Exits; Dispatch to the appropriate interruption handling routine, or 
return to the last interrupted routine. 

SIR — Specify Interruption Routine 

Entry Point ; CZCJSA. The standard type-I or type-II linkage and a 
parameter list are generated during expansion of the SIR macro 
instruction. 

Operation ; This routine first disables interruptions if they were 
enabled when it gained control. It then checks for these errors: 

• Parameter list is invalid - 

• A nonprivileged user wishes to build a privileged ICB - 

• A nonprivileged user wishes to build an ICB with a priority greater 
than 127 - In these cases the ICB is set invalid and an error return 
code of 12 is placed in register 15 at ICBRTN. The PTI macro is 
then issued at SIRTRN to enable interruptions if they were enabled 
at start of execution, and this routine returns to the calling 
program. 

• There is no ICB parameter - Processing continues at SIRTRN. 

The pointer to the ICB is obtained from the parameter list supplied in 
the macro instruction. More error checks are then performed; 

• The ICB is not on a fullword boundary - 

• The user is not permitted access to this ICB. (This is determined 
by issuing the CKCLS macro) - In these cases, processing continues 
at ICBRTN. 

The COMAREA is then checked for valid construction; 

• User is not permitted access to this COMAREA - 

• COMAREA is not on word boundary - 

• ICB type not legal - In each of these cases, processing continues at 
ICBRTN. 

If the ICB is for a synchronous or asynchronous I/O interruption, the 
DCB is checked; 

• DCB is not in virtual memory - 
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• DCB is invalid - 

• DCB is not opened - In each of these cases, processing continues at 
SIRTRN. 

If the DCB is valid, this routine checks for a device entry. If none 
exists, it builds one. It then checks for an RE queued on the ICB. If 
there is one, and the ICB is for a timer, the cancel clock routine 
CCZCJZ) is called to cancel the clock. 

• Error in cancel clock processing - Processing continues at SIRTRN. 
Set clock is then called at resetiME to reset the clock. 

• Error in set clock processing - Processing continues at SIRTRN. 

If the reset flag is set, it is turned off and this routine checks for 
more parameters, processing them at SIRLOOP if there are any and return- 
ing at SIRTRN if there are not. If the reset flag is not on, a new RE 
is built and inserted in the RE chain before the check for more parame- 
ters is made. 

When there is no RE, or if it was deleted, this routine checks for a 
timer DE. If there is one, processing continues at RESETIME. If there 
is no timer DE, a new RE is built and inserted in the RE chain. A check 
for more parameters is made. If there are none, exit is at SIRTRN. If 
there are more, their processing begins at SIRLOOP. 

Routines Called ; Set clock (CZCJY) , cancel clock (CZCJZ). 

Exits: Return to the calling routine with the appropriate return code. 

DIR— Delete Interruption Routine 

Entry Point ; CZCJDA- The standard type- I or type- II linkage and a 
parameter list are generated during expansion of the DIR macro 
instruction. 

Operation ; This routine first issues the ITI macro instruction to dis- 
able interruptions if they were permitted on entry. The first parameter 
from the list generated by the macro is obtained at DIRLOOP. A series 
of error checks is then performed; 

• Invalid parameter list length - 

• No ICB pointer - 

• Nonprivileged routine attempting to delete privileged ICB - In these 
cases, processing continues at DIRTRN. Interruptions are permitted 
if they were permitted on entrance to this module. Register 1 is 
loaded with the invalid ICB pointer, if there was one, and this rou- 
tine returns control to the calling routine with an appropriate 
return code in register 15. 

When there is an asynchronous DE chain and a device entry match for the 
DCB in question, the DQRE subroutine is used to dequeue all REs and QEs 
that match this DCB. If there is no asynchronous chain or no match for 
the DCB, this processing is repeated for the synchronous chain. When 
there is no synchronous DE match for the DCB, this routine returns at 
DIRTRN. 

A series of error checks is then made; 

• Invalid ICB - 
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• No QEs on ICB chain - 

• DCB not valid - 

• No DE matching DCB - 

• RE has been deleted - In any of these cases, processing continues at 
DIRTRN, 

If the ICB is for a clock, the task monitor's cancel clock routine 
CCZCJZ) is called to cancel that clock. 

• Error in cancel clock processing - Processing continues at DIRTRN. 

If the RE is not active, it is dequeued, together with all the QEs on 
that RE« A test is then made for more parameters. If there are more, 
their processing begins at DIRLOOP. If not, this routine returns con- 
trol at DIRTRN- 

If the RE is active, it is left intact, but all its QEs are dequeued. 
This routine then exits at- DIRTRN, 

Routines Called : Cancel clock CCZCJZ). 

Exits ; Return to the calling routine with the appropriate return c»de. 

INTINQ — ^Interrupt Inquiry 

Entry Point ; CZCJIA. The standard type- I or type- II linkage and a 
parameter list are created during expansion of the INTINQ macro 
instruction. 

Operation ; This routine first disables interruptions if they were per- 
mitted on entrance. It then performs the following series of error 
checks : 

• ICB pointer is zero - 

• A nonprivileged user is checking a privileged ICB - 

• DE type is invalid - In these cases, processing continues at 
RETRN08. A return code of 8 is placed in register 15, task inter- 
ruptions are permitted if they were permitted when this routine 
received control, and control is returned to the calling routine. 

This routine then branches on DE type to check the validity of the 
interruption type. Basic processing is the same for each interruption 
type, but various checks must be made first as follows (processing con- 
tinues at the label given) : 

APROGRAM; Interruption code zero; RETRN08. 
Otherwise : ATIMER . 

ATIMER ; Interruption code greater than 15: CATEST. 
Otherwise: TESTOK. 

ASVC : SVC code greater than 64: CATEST. 
Otherwise: TESTOK. 

ASYNCH ; Interruption code zero: RETRN08. 

Interruption code greater than six: CATEST. 
Otherwise: TESTOK. 
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Q-ther Types ; TESTOK. 

At CATEST, this routine tests tiPio of the parameters proirided by the 
expansion of the INTINQ macro instruction. If neither "CLEAR* nor "ANY* 
were specified, processing continues at RETRN08* Otherwise, at TESTOK, 
if the ICB was for a synchronous or asynchronous I/O interruption, the 
following six error checks are performed; if not, only the last is done: 

• ICB does not point to a DCB - 

• No DE-ICB match - 

• DCB not open - 

• No DEB pointer - In each of these cases, processing resumes at 
RETRN08. 

• No DE-ICB match - 

• No RE-ICB match - Processing continues at RTRN04 . A return code of 
^ is placed in register 15, and, at INTRTRN, task interruptions are 
permitted if they were on entrance, and control is returned to the 
calling routine. 

When there are none of the above errors, but there are no QEs on the 
RE, a test is made at RETRNMOC to see if the interruption routine is in 
the wait state, pending the availability of the desired information. 
When the routine is in the wait mode, the AWAIT macro is issued. Task 
interruptions are then disabled, and control is returned to the calling 
routine . 

When there are QEs on the RE, a test is made on the INTINQ type. If 
it is "CLEAR", all QEs are zeroed and dequeued, any associate message 
areas are freed, and return processing continues at INTRTRN, with a 
return code of being placed in register 15. When the interruption was 
asynchronous and the ICB is for an attention from SYSIN, the attention 
counter is decremented - 

When the INTINQ type is "ANY", a check is again made to see if the 
interruption code in each type of QE match^ one allowed by the ICB. 

• No QE-ICB match - Processing continues at RETRNMOC. 

When the match is found, processing continues at MOV. If the RE is non- 
privileged, the privilege class of the COMAREA is tested, using the 
CKCLS macro instruction. 

• Privileged COMAREA being used by nonprivileged user - Processing 
continues at RETRN08. 

The necessary data is then moved from the QE into the COMAREA and the 
attention counter is decremented. If the QE is for an external inter- 
ruption, the message is moved from the QE message area to the user area. 
CKCLS is used to test the user area. 

• Nonprivileged user has privileged message area - The message is 
moved into an area obtained by issuing the GETMAIN macro instruc- 
tion, rather than the user-specified area. 

FREEMAIN is called to free the original message area. Information about 
the message and message area is moved into the ICB, and control is 
returned to the calling routine. 

If the type is not "ANY," a QE must be found with an interruption 
type that matches the one specified in the parameter list. 
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• No QE- parameter list match - Processing continues at RETRNMOC. 
When the proper QE has been found, processing continues at MOV, 

Routines Called ; FREEMAIN (CZCHA3>, 

Exit ; Return with the appropriate return code. 

STIMER/TTIMER Routine 

Entry Point ; CZCJAl. The linkage is created during expansion of the 
STIMER/TTIMER nacro instruction. 

Operation ; This routine performs the following functions: 

1. Sets a clock. 

2. Cancels a clock. 

3. Sets a clock and waits for the interruption from that clock. 

4. Tests a clock. 

On entry this routine checks for the following error conditions; 

• Clock number is invalid - 

• Clock number indicates a privileged clock used in a function other 
than "TEST" - In either of these cases, an error return code of four 
is set at RETURN04 and control is returned to the calling routine. 

Test Task Clock — When the clock has not been set, control is 
returned to the calling routine with an error return code. Otherwise, 
the XTRTM macro is used to find out how much task time has already been 
used. This is subtracted from the requested amount to get the remaining 
task time. Control is returned to the calling program with this remain- 
ing time as a parameter. 

Test Real Clock — When the clock has not been set, processing is the 
same as above for that condition. Otherwise, the REDTIM macro is issued 
to find the amount of real time that has been used by the task. The 
real time remaining to it is then computed, and converted to millisec- 
onds. This number is stored in register 0, and control is returned to 
the calling routine. 

Set Function — If there is no ICB pointer, GETMAIN is used to get 
main storage for an ICB and communications area. The address of this 
ICB is stored in the SIR parameter list. This routine then branches to 
the SIR routine CCZCJSA> to specify the ICB for the timer interruption. 

• SIR request brings total task time above 7 1/2 hours - A return code 
of eight is placed in register 15, and control is returned to the 
calling routine. 

• Other abnormal return - Processing continues at RETURN04. 

If SIR operation was normal, a successful return code of zero is set at 
RETURNOO, and control is returned to the calling program. 

Cancel Function — This section of the program immediately checks for 
the following error; 

• No ICB pointer - In this case, processing continues at RETt3RN0<*. 
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If there is an ICB address , it is placed in the DIR parameter list and 
this routine branches to DIR in order to delete the ICB. 

• Error return from DIR - Processing continues at RETURNO^. 

Opon successful return from DIR, processing terminates at RETURNOO. The 
time remaining when the task was canceled is passed to the calling 
routine. 

Wait Function — If there is no ICB address, GETBiAIN is called to get 
main storage for the ICB and a COMAREA, The ICB address is then placed 
in the SIR parameter list, and the entry point in the ICB is zeroed. 
This routine then branches to INTINQ in the wait mode. 

• Error return from INTINQ - Processing continues at RETURN04. Upon 
normal return from INTINQ, exit is at RETURNOO. 

Routines Called ; SIR CC2CJS), DIR (CZCJD), INTINQ (CZCJI) . 

Exit ; Return to the caller with the appropriate return code. 

Set Clock Routine 

Entry Point ; CZCJYE. It is called by other task monitor routines via 
type-I linkage. 

Operation ; On entrance, this module calls the task monitor time conver- 
sion routine (CZCJX) , to convert the input time into microseconds. 
Checks are made on the success of CZCJX, the clock number, and the clock 
type; 

• CZCJX unsuccessful - 

• The clock number is invalid - 

• The clock type is invalid - In each of these cases, an error return 
code is set at STOl, and control is returned to the calling routine. 

Real Time Clock — If the clock to be set is presently active, cancel 
clock (CZCJZ) is called to turn if off. The desired interval is then 
set in the clock and it is activated. When the pointer in the header to 
the first clock is zero, and the time is not to be set on the last clock 
in the chain, the clocks are sorted into time order, a successful return 
code is set, and control is returned to the calling program. If the 
clocks do not need to be sorted, the SETTR macro is issued. The return 
code from SETTR is then tested; 

• Time requested has passed - 

• System limit was reached - On either of these conditions, an error 
return code is set, and control is returned to the calling routine. 

If the time set was accepted, the interval is placed in the clock head- 
er, a successful return code is set and control is returned to the call- 
ing routine. 

Task Time Clock — The requested time interval is first changed from 
microseconds into milliseconds. If the clock to be used is active, it 
is cancelled by the cancel clock routine (CZCJZ). The XTRTM macro is 
then used to extract the amount of CPU time the task has already used. 
The amount of further task time requested is then added to this- 

• Total task time is greater than 7 1/2 hours - In this case, an error 
return code is set and control is returned to the calling routine. 
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When the amount of requested task time is permissiblet it is moved into 
the clock and the clock is activated. If the pointer in the header to 
the first clock in the active chain is zero, and if the clock being set 
is not the last on the chain, the clocks are sorted by time, a success- 
ful return code is set and control is returned to the calling routine. 
When a sort is not necessary, the SETTU macro is issued, the successful 
return code is placed in register 15, and control is returned to the 
calling routine. 

Routines Called ; Cancel clock (CZCJZ), time conversion CCZCJX). 

Exits ; Return to the calling program with the appropriate return code. 

Cancel Clock Routine 

Entry Point ; CZCJZE. It is called by other task monitor routines via 
type-I linkage. 

Operation ; The following error conditions are checked; 

• Clock number invalid - 

• Clock type invalid - In either of these cases, an error code is set 
and control is returned to the calling routine. 

When the clock to be canceled is not active, a successful return code is 
set at CCRET, and control is returned to the calling routine. When it 
is active, it is canceled. If it is the first clock on the active list, 
the pointers on the active list are adjusted, and processing continues 
at CCRET, 

• Pointer to the active list is zero - An error return code is set and 
control returns to the calling program. 

When the canceled clock is the last clock on the active list, the for- 
ward pointer on the previous clock is adjusted and processing continues 
at CCRET. 

If the canceled clock is not the last active clock, it is removed 
from the active list and the pointers of the clocks around it are 
adjusted. Processing continues at CCRET. 

Routines Called ; None . 

Exits ; Rettirn to the calling routine with the appropriate return code. 

Time Conversion Routine (CZCJX) 

Entry Point ; CZCJZA. The time conversion routine is called by set 
clock via type-I linkage. 

Operation ; This routine contains a group of subroutines that convert 
time parameters, in any of several formats, into a form suitable for 
input to the SETTR supervisor program or, when converted to millisec- 
onds, for the SETTU supervisor program- Initially, the validity of the 
input data, as specified in the parameter list, is checked. If this 
input is invalid, control goes to CZCJXB to cause a SYSER. If the input 
is valid, control goes to CZCJXC for conversions required for task time, 
or control passes to CZCJXD for conversions required for real time. At 
these two points, the conversion code is used as an index to a transfer 
vector that causes control to pass to either the proper data conversion 
program, or to an error routine if the type of conversion indicated is 
invalid for the type of time required. 
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As "the data is being converted, and if another conversion routine is 
needed for immediate processing, a direct branch is made to the required 
routine. When that routine has completed processing, it uses the con- 
version code to determine the point at which it should return. In addi- 
tion, for real-time requests, the system time-of-day value is added to 
the requested time, if a decimal or binary interval was specified. 

The discussion below provides a descriptiom of the various conversion 
subroutines: 

DECIMAL INTERVjy;. (CZCJXF) : A decimal interval, given as eight unpacked 
decimal characters, is converted to binary by first converting to packed 
decimal format and then isolating hours, minutes, and seconds. The 
hours, minutes, and seconds are converted to microseconds, and an accu- 
mulated total is foinned. This total is then converted into binary form. 
Ml exit is made to either the time-of-day CCZCJXHI) routine or the con- 
version executive CCZCJXE) . 

BINARY INTERVAL (CZCJXG) : A binary interval, expressed as a 32-bit 
number of milliseconds, is converted to microseconds by multiplying it 
by 10 00. The output is stored, and an exit is made to the conversion 
executive (CZCJXE) . 

TIME-QF-DAY (CZCJXH) ; To convert a time-of-day, given as eight unpacked 
decimal numbers, to a unique calendar or real time, the value is first 
converted to microseconds. Then the current time is obtaii^d from the 
supervisor, as well as the current serial day number. Today's time-of- 
day is obtained and compared with the desired time-of-day. If the pres- 
ent time-of-day is less than the requested value, the current serial day 
number is added to the input time-of-day; the result is the final out- 
put. If the present time is greater than the requested time-of-day, the 
serial day number is increased by one before adding it to the input 
time-of-day. Exit is made to CZCJXE. 

DAY-QF-THE-WEEK (CZCJXI) ; The current serial day number is obtained 
from the supervisor. The serial day number of a known Sunday is sub- 
tracted from this number. The result is divided by seven to obtain a 
number of weeks and a remainder. A search is then made to determine 
which day-of-the-week is being requested. The number of the day-of-the- 
week that is wanted is then used to determine the days to be added to 
the current search day number. If the number to be added is found to be 
negative, a week (seven days) is added to the serial day number. Other- 
wise, the positive number of days is added. The result is converted to 
microseconds and stored. Exit is made to CZCJXE. 

DAY- OF- A- MONTH ( CZCJXJ) : The current serial day number is obtained from 
the supervisor and converted by CZCJXM to a calendar date. From this 
date the current day-of-the-month is extracted. Then, if the requested 
day-of- the- month is beyond the current one, 1 is added to the current 
month. If the month becomes 13, 1 is added to the year, and the month 
is reset to 1. A search is then made for the next month in which the 
requested day-of-the-month is valid. When found, the resulting calendar 
data is converted by CZCJXL to a serial day, and then to microseconds. 
Exit is made to CZCJXE. 

DAY-OF-A-YEAR CCZCJXK) ; The day part of the input is used to determine 
the month and day that corresponds to the calendar date, leap year being 
considered. This is converted to a serial day number and then to micro- 
seconds. The output is stored and an exit is made to CZCJXE. 

CALENDAR DATE (CZCJXL) : This subroutine converts a calendar date to a 
serial day by using an algorithm. If the month portion of the input 
exceeds 2, 3 is subtracted from it; otherwise, 9 is added, and 1 is sub- 
tracted from the y^r. The serial year is computed as (l«»61y)/t|. Next, 
the month is converted as (153m-i'2)/5. The year, month, and day are then 
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combined and converted to binary to form a serial day, which is stored 
as output. Control returns either to CZCJXJ2 or CZCJXKl. 

SERIAL DAY CCZCJXM) ; This subroutine converts a serial day number to a 
calendar date. First, the input is converted to packed decimal, and the 
final year, month, and day portions of the output are computed. If the 
month is less than 10, 3 is added. Otherwise, the month is reduced by 
9, and 1 is added to the year. Exit is made to CZCJXJl. Mter the 
necessary conversions have been made, control returns to CZCJXE, where 
registers are restored, and control is returned to the calling program. 

Routines Called ; None. 

Exit ; Return. 

Leave Privilege Routine 

Entry Point ; CZCJLE. Leave privilege may only be called by a privi- 
leged program, via type-I linkage. 

Operation ; Task interruptions are disabled using the ITI macro instruc- 
tion. The following errors are then checked; 

• The enter flag is off - 

• The P3 flag is on - 

• The current VPSW is nonprivileged - When any of these are true, the 
SYSER macro is issued for an invalid use of the leave privilege rou- 
tine, and exit is to ABEND (CZACP) . 

Otherwise, the ISA save area 1 and the enter save area are combined into 
a LVPRV save area. The GETMAIN routine (CZCH2) is used to get a non- 
privileged short save area, and the P3 flag is turned on to indicate 
type- III linkage. This routine then executes an LVPSW instruction to 
give control to the nonprivileged program. 

Routines Called ; GETMAIN (CZCH2). 

Exits; ABEND, nonprivileged routine via LVPSW. 

Cleanup Routine 

Entry Point ; Either CZCJCU via type-I linkage or CZCJC2 from the ENTER 
SVC routine. 

Operation ; At CZCJCU this routine first inhibits task interruptions if 
necessary, using the ITI macro instruction. The cleanup flag is then 
turned on, and cancel clock CCZCJZ) is called to cancel all nonprivi- 
leged clocks, real or task time. 

When the HARE is nonzero, its privilege is checked. If it is non- 
privileged, it is zeroed. If it is privileged, the pointers to any non- 
privileged REs chained to it are zeroed. 

When CARE is not zero but nonprivileged, it is zeroed. This routine 
then checks for nonprivileged QELs. If there are any they are cleared, 
and their space is set available. When any of the QELs are external, 
the message areas associated with them are freed. After the QELs are 
cleared, or if there were no nonprivileged QELs, processing continues at 
CCIO with the next DE. When the HARE on this DE is nonzero and nonpriv- 
ileged, it is zeroed. The REs are then examined, starting with highest 
priority RE. Privileged REs are skipped. When the pointer to the RE is 
not zero it is zeroed. At CC40 , if there are any QEs on the RE, they 
are cleared, and their space is made available. The message areas for 



any external QEs are freed • When there are no more QEs, the RE is 
cleared and itade available. If there are any more REs on this DE^ their 
processing continues at CC40, When there are no more REs, or if their 
pointers were originally zeroed, processing of the next DE continues at 
CCIO. When there are no more DEs, any nonprivileged save areas are 
zeroed. At CC20, if there are no pending type-Ill linkages, the pointer 
to the pushdown stack is zeroed, the PTI macro instruction is issued to 
permit task interruptions if they were permitted on entrance to this 
module, and control is returned to the calling program. If there are 
any pending type-Ill linkages, return is to the SVC processor's forced 
return point, CZCJR2, 

When this routine is entered at CZCJC2 from the enter SVC processor, 
processing begins at CC20. 

Routines Called ; Cancel clock (CZCJZE) , FREEMAIN (CZCH3). 

Exits: Task monitor's ENTER SVC processor CCZCJR2), return to the call- 
ing routine. 
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FLOWCHARTS 



The flowcharts in this manual have been produced by an IBM program, 
using ANSI symbols. The symbols are defined in the left column below, 
and examples of their use are shown at the right. 



B1 . 

Iterminal block J 





n' — 7 

/INPUT/OUTPUT / 
/ BLOCK / 



DEFINITION 



INDICATES AN ENTRY OR 
TERMINAL POINT IN A FLOW- 
CHART; SHOWS START, STOP, 
HALT, DELAY. OR INTERRUP- 
TION. MAY ALSO INDICATE 
RETURN TO THE CALLING 
PROGRAM . 



INDICATES A PROCESSING 
FUNCTION OR A DEFINED OP- 
ERATION CAUSING CHANGE IN 
VALUE, FORM OR LOCATION 
OF INFORMATION. 



INDICATES A DECISION OR 
SWITCHING-TYPE OPERATION 
THAT DETERMINES WHICH OF 
A NUMBER OF ALTERNATE 
PATHS SHOULD BE FOLLOWED. 



INDICATES A SUBROUTINE OR 
MODULE THAT IS DESCRIBED 
IN THIS MANUAL 



INDICATES A SUBROUTINE OR 
MODULE THAT IS INCLUDED 
IN THE FLOWCHARTS OF AN- 
OTHER MANUAL. 



INDICATES GENERAL I/O 
FUNCTIONS, SUCH AS GET, 
PUT, READ, WRITE, SIO, 
AND DEVICE -CONTROL MACRO 

INSTRUCTIONS. 



INDICATES A PROCESS THAT 
CHANGES SYSTEM OPERATION. 
FOR EXAMPLE, SETS A SWITCH, 
MODIFIES AN INDEX REGISTER, 
OR INITIALIZES A ROUTINE. 



INDICATES ENTRY TO OR EXIT 
FROM ANOTHER BLOCK ON THE 
SAME FLOWCHART PAGE. 



INDICATES ENTRY TO OR EXIT 
FROM A BLOCK ON ANOTHER 
PAGE OF THE SAME SET OF 
FLOWCHARTS . 



B3 . 

f COMNAME \ 



MODNAME IS THE LOAD MODULE OR LIBRARY 
NAME OF THE ROUTINE DESCRIBED BY THIS 
FLOWCHART . 



OTHERMOD INDICATES THE MODULES PASSING 
CONTROL TO THIS MODULE AND THEIR FLOW- 
CHARTS . 



C3: CSECT IS THE CSECT NAME OR OTHER ENTRY 
POINT AT WHICH PROCESSING BEGINS. 




VIA: PASSMECH 




J 



D3: PROGRAM EXECUTION CONTINUES WITH BLOCK 
H3 WHEN THE DECISION IS NO, OR 
BLOCK E3 WHEN THE DECISON IS YES. 



E3: LABEL2 IS THE LABEL OF THE SECTION OF 

CODE IN THIS ROUTINE FROM WHICH CONTROL 
IS PASSED TO THE SUBROUTINE. CONTROL 
RETURNS TO THE NEXT INSTRUCTION FOLLOW- 
ING THE SUBROUTINE CALL. 

ENTRYPT IS THE ENTRY POINT. 

SUBRTN IS THE COMMON NAME OF THE SUB- 
ROUTINE IN FLOWCHART AG. 



LABEL3 IS THE LABEL OF THE SECTION OF 
CODE FROM WHICH CONTROL IS PASSED TO THE 
PREDEFINED PROCESS PDPNM, WHICH IS 
DOCUMENTED IN ANOTHER PUBLICATION 
(-PDPNM- MAY ALSO BE USED IN A PROCESS- 
ING BLOCK) . 



EXECUTION CONTINUES WITH BLOCK H3 WHEN 
THE DECISION IS YES, OR WITH BLOCK A1 ON 
PAGE 2 OF THIS SET OF FLOWCHARTS WHEN 

THE DECISION IS NO. 

THE OFFPAGE CONNECTOR MARKED 01 H3 INDI- 
CATES THAT EXECUTION CONTINUES WITH BLOCF 
H3 FROM ANOTHER PAGE OF THIS SET OF FLOW- 
CHARTS. THIS CONNECTOR IS ALSO PAIRED 
WITH THE ONPAGE CONNECTOR FROM BLOCK D3 . 



H3: LABEL4 IS THE LABEL OF A SECTION OF CODE 
OF THIS ROUTINE THAT INITIATES I/O. 



NEXTRTN IS THE COMMON NAME OP THE ROUT- 
INE THAT EXECUTES AFTER THIS ROUTINE. 

ENTRYPT IS THE ENTRY POINT OF NEXTRTN, 
WHICH IS DESCRIBED IN CHART AC. 



EP=ENTRYPT 
CHART AC 
VIA: PASSMECH 
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Chart AA. Program Interruption Processor (CZCJT) (Part 1 of 2) 
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Chart Ml. Program Interruption Processor (CZCJT) (Part 2 of 2> 
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Chart AB, SVC Interruption Processor CCZCJT) (Part 1 of 3) 
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Chart AB. SVC Interruption Processor (CZCJT) (Part 2 of 3) 
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Chart AB. SVC Interruption Processor (CZCJT) (Part 3 of 3) 
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Chart AC. Timer Interruption Processor (CZCJT) (Part 1 of 2) 
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Chart AC. Timer Interrupt ion Processor CCZCJT) (Part 2 of 2) 
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Chart AD. Ixternal Interruption Processor CCZCJT) 
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Chart AE. Synchronous and Asynchronous Interruption Processors CCZCJT) 
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Chart AF- Data Set Paging and VSS Interruption Processors (CZCJT) 



fDATA SET PAGINgI 



/" VSS DSP ^ 

f INTERRUPT RTN I 




^-.3 ^^ 

f VSS INTERRUPT I 



PUT DSP SA FROM 
PSECT IN R13. 
TURN ON VMIER 

FLAG 



TURN OFF VMIER 

FLAG RESTORE 
FROM SHORT SAVE 



f RETU 



I ABEND J 




J 



Flowcharts 59 



Chart AG. Queue Linkage Entry Routine CCZCJT) (Part 1 of 4) 
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Chart AG. Queue Linkage Entry Routine (CZCJT> (Part 2 of 4) 
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Chart AG. Queue Linkage Entry Routine (CZCJT) (Part 3 of 4> 
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Chart AG. Queue Linkage Entry Routine (CZCJT) (Part H of 4) 
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Chart AH. Scanner/Dispatcher (CZCJT) (Part 1 of 5) 
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Chart AH. Scanner/Dispatcher CCZCJT) (Part: 2 of 5) 
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Chart AH. Scanner/Dispatcher (CZCJT) (Part 3 of 5) 
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Chart AH. Scanner/Dispatcher (CZCJT) (Part H of 5) 
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Chart AB. Scanner/Dispatcher (CZCJT) (Part 5 of 5) 
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Chart AI. Specify Interruption Routine (CKJS) 
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Chart AJ. Delete Interruption Routine CCZGJD) (Part 1 of 2) 
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Chart AJ- Delete Interruption Routine CCZGJD) (Part 2 of 2) 
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Chart AK. Interruption Inquiry Routine CCZCJI) (Part 1 of 3) 
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Chart AK. Interruption Inquiry Routine (CZCJI) (Part 2 of 3) 
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Chart iyc. Interruption Inquiry Routine CCZCJI) (Part 3 of 3) 
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Chart AL- Set Timer /Test Timer (CZCJA) 
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Chart AM. Cancel Clock Routine (CZCJZ) 
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Chart AN. Set Clock Routine (CZCJY) 
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CANCEL CLOCK 

SET ERROR 

RETURN CODE =4 







© 
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Chart AO. Leaire Privilege Routine CCZGJI,) 



CEAVE PRIVILEGED 
ROUTINE J 




-CEAIS- SYSER 

INVALID LVPRV 

CALL 



3 



COMBINE ISA 
SAVE AREA 1 AND 
ENTER SAVE AREA 
INTO LVPRV SA. 



GET MA IN 

NONPRIV SHORT 

SAVE AREA 



SET UP REGISTER 

FROM ISA SAVE 

AREA 1 AND 

PARAI«!ETER LIST 



MOVE R-COK FROM 


PARAMETER LIST 


TO WORD 19 OF 


SAVE AREA 



-. K2 

/LOAD VPSW FOR 
INONPRIV ROUTINE 



3 
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Chart AP. Cleanup Routine (CZCJC) 



fCLEANUP ROUTINEI 



-ITI- DISABLE 

INTERRUPTS IF 

CURRENTLY 

ENABLED 



CANCEL ALL REAL 

S TASK NONPRIV. 

CLOCKS 





SET HARE=0 



SET CARE = 
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The task monitor uses tables for the storage ^ recovery, and transfer 
of information. Each control block is used during particular phases of 
task monitor operation, depending upon the kind of information required 
during each phase (see Figure 8) . System control blocks reside in vir- 
tual storage, and each task has its own copy of those it uses. For the 
layout and exact contents of each system control block (CHJUCXX) men- 
tioned here, see System Control Blocks , GY28-2011. 

CHAISA ; The interruption storage area holds the status of a particular 
interruption. It contains the old VPSW and the new PSW used by task 
interruption control to give control to the correct interruption proces- 
sor. The interruption processors perform register saves in the ISA, and 
reference it for information on VSS operation, interruption and SVC 
codes, privilege state, and certain special conditions. 

CHAITB: The task monitor interruption table, sho%<m in Figure 4, con- 
tains the queues that allow the task monitor to process interruptions by 
priority. The ITB is referenced by QLE, which builds QEs and queues 
th«n on the appropriate RE for the appropriate DE for that interruption 
type. The scanner/dispatcher references and dequeues QEs and REs upon 
dispatch to the specified routine for the interruption. SIR uses infor- 
mation from the interruption control block to create an RE if necessary, 
or initialize it if it has already been created. DIR dequeues and 
clears the RE and QE associated with a particular ICB. INTINQ 
references the ITB in order to determine the status of an interruption, 
and in "CLEAR" mode, zeros and dequeues all QEs on the RE. Cleanup 
clears and dequeues all nonprivileged REs and QEs. 

CHAIDE: Interruption device entries are chained to each other, and 
contain pointers to the highest priority and highest priority 
active RE queued on them. 

CHAIRE: The interruption request entries on a DE are chained to 
one another. Each contains a code for an L-type RE and an activity 
indicator. They also contain a priority number ^ a privilege flag, 
and pointers to the ICB, the first QE, and to the task monitor's 
pushdown save area. 

CHAIQE ; The interruption queue entries on a particular RE are 
chained together. The QE contains a code for L-type, and an inter- 
ruption type. The rest of the fields contain information peculiar 
to that type of interruption. 

CHAICB ; The interruption control block contains the information neces- 
sary to interruption handling routines. It is used by QLE, the scanner/ 
dispatcher, SIR, DIR, and INTINQ- It contains a pointer to the COMAREA, 
and for I/O interruptions, a pointer to the DOB. It also contains the 
entry point R- and V-cons for the interruption handling routines. There 
are special ICB fields for each interruption type. 

CHADCB ; The data control block controls I/O operations and is used only 
for synchronous or asynchronous I/O interruptions. INTINQ, SIR, DIR, 
QLE, and the scanner/dispatcher refer to it. 

CHADEB : The data extent block is referenced by the same task monitor 
routines that use the DCB. It too, is an I/O control block, containing 
information about the data set to be used as input or output, and also 
about the storage medium for the data set. 

CHAIOR : The I/O request control block controls the transfer of data 
between main storage and virtual memory. It is referenced by the syn- 
chronous I/O interruption processor for the address of the appropriate 
I/O posting routine. 

Data Areas 8 3 



CHAMCB s The message control block is used by the task monitor external 
interruption processor to implement inter-task communications. It con- 
tains a message text, a 'reply expected* flag, and a VSEND SVC. 

CHACOM: The communications area, or COMAREA, contains basic interrup- 
tion information transferred from the QE by the scanner/dispatcher. 
This information is referenced by INTINQ, DIR, and QUE. It consists of 
the interruption type and the interruption code within that type. For a 
program, SVC or timer interruption, the COMAREA also contains the 
address of the point of interruption. For an external interruption, it 
contains the address of a message area, and for a synchronous or asynch- 
ronous I/O interruption, it contains channel sense information. 

CHASDA ; The symbolic device allocation table is used to indicate the 
status of any device which has a DE in the ITB. It is used by QLE. 

CHAPDS: The task monitor's pushdown save area consists of dynamically 
allocated storage used by the task monitor to save both task monitor and 
user status. If processing for one user must be interrupted for initial 
processing of another interruption, this save area allows resiimption of 
processing for the first user with integrity. The fact that this 
storage is dynamically allocated makes task monitor code reenterable. 

CHACIiH and CHACLK ; The task monitor clock list header and clocks. The 
clock list header contains the time value used in the SETTR or SETTU 
macro, and a pointer to the first active clock. A real or task clock 
contains an activity indicator, the real or task time already used, and 
the time requested. 

CHAETl and CHAET2 : The enter tables are used by the task monitor ENTER 
SVC routine. Table 1 points to table 2 and indicates the highest valid 
enter code. Table 2 contains the V-cons and R-cons necessary to trans- 
fer control from one routine to another. 

TMPSECT: The task monitor's prototype control section contains several 
19 -word save areas for routines called or dispatched by the task mon- 
itor; for example, QLE, RSPRV, and the dynamic loader. It also contains 
R- and V-cons for the dynamic loader, virtual storage allocation, DIAG- 
NO, PCS, and parts of the command system. The PSECT contains the 16 
task and 16 real clocks and the task monitor's log, which contains a 
record of the last fifty task interruptions. A more complete descrip- 
tion of the TMPSECT fields can be found in the "Diagnostic Aids" section 
of this book. 
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CONTROL BLOCKS REFERENCED BY THE TASK MONITOR (I): THE INTERRUPTION TABLE 
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CONTROL BLOCKS REFERENCED BY THE TASK MONITOR (II): I/O CONTROL BLOCKS 
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DATA REFERENCE BY TJUSK MONITOR MODULES 

This table lists the control blocks and work areas that are used by 

each nodule of the task monitor during processing. 



Table 4, Data Reference by Task Monitor Modules' 



h 



MODULE I 
Table, I Task 

Workar ea , et c , j Moni to r 

Interrupt Storage | 
flx'ea {ISA) |C 

i 
I/O Record Controlf 
Block (lORCB) |R 

i 

Task Common j 
(TCM) R 



Enter Table 



I 



Message Control I 
Block CMCB) JR 

! 

Interrupt Table I 
(ITB) |-'- 

I 
Dtita Extent Block | 
CDEB) 



Data Control Block 
CDCB) 

Interrupt Control 
Block CICB) 

I De-^ice Entry 
I CDE) 

j Request Entry 

I fRE) 

1 

I Queue Entry 

I CQE) 

i 

I CoiBEunications 

[Area CCOMI 

I 

{Symbolic Device 

I Table (SDAT) 

I 

[Task Monitor 
I Clocks (cue) 
h 



Scanner/ 
Dispatcher 



— .JL—™-™ - 



i 1 j j JSTIMER- JTime |Set ( Cancel ( j j 
1 QLE ( SIR 1 DIR 1 INTINQ j TTIMER | Conv . j Clock j Clock 1 Cleanup | LVPRV ; 

1 ,„ i 1. ._ 1 „ ,,. ... ._ i. , 1 ... .„ J. ,,, „ i ,,.. _.. i. ... ^ _ 1 ,„ _ J 


|C |C |C |C |— 1 — \— 1 — (C JC 1 

|C |C |c |c 1 — |~~ (-- |— |c 1 — 1 

|R |R |R |R I— 1 — I-- 1 — I— |— 1 
|R jR |R fR 1 — 1 — |-~ I— j — 1 — j 
|C |R |R |R |C 1 — ■ 1"-- 1 — |C 1 — 1 

|C |C |c |c j — 1 — |~ 1 — jc 1 — 1 
|C |C |C |C |-~ |~- — 1 — |C |— 1 

|c 1 — |c |c 1 — 1 — ; -- |— |c 1^ — 1 

|R |— |— IC |R 1 — 1-- |— |C I— 1 
fR j— j— I— f— I— (».™ I— I— I— 1 
|— |-~ |— [— |R |— fC |C |C |— j 



|R = Reference only? C = Change 
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Table 5, 

r • 



Microfiche Directory 



|EP Name 
I CZCJAl 
I CZCJCU 
I CZCJC2 
I CZCJDA 
I CZCJEM 
I CZCJHJ 
ICZCJER 

ICZCJIA 
ICZCJLE 
ICZCJQS 
ICZCJR2 

I CZCJRC 
I CZCJRH 
I CZCJSA 
I CZCJTA 
I CZCJTC 
I CZCJTH 
I CZCJTI 
I CZCJTL 
I CZCJTP 
I CZCJTS 
I CZCJTT 
I CZCJTV 
I CZCJTX 
I CZCJTY 
ICZCJXA 
I CZCJYE 
[CZCJZE 
I SCAN 
I SOP 



Name of Item 

STIMER/TTIMER roii-tine 

Cleanup routine 

Cleanup — EP 2 

DIR routine 

Program interruption processor 

Last instruction in CSECT 

SVC interruption processor Center 
routine) 

INTINQ routine 

Leave privilege routine 

QLE routine 

SVC interruption processor (restore 
privilege routine) 

Real time clocks 

Real time clock header 

SIR routine 

Asynchronous interruption processor 

Task time clocks 

Task time clock header 

Synchronous I/O interruption processor 

Task log 

Program interruption processor 

SVC interruption processor 

Timer interruption processor 

VSS interruption processor 

External interruption processor 

Data set paging interruption processor 

Time conversion routine 

Set clock routine 

Cancel clock routine 

Scanner/dispatcher routine 

Scanner/ dispatcher routine (standard 
optimal procedure subroutine) 





ICZECT or 


1 Chart! 


j Module 

+-- 

ICZCJA 


1 PSECT 

\- 

1 CZCJAC 


1 ID 1 
|AN 1 


1 CZCJC 


1 CZCJCC 


|AP 1 


1 CZCJC 


1 CZCJCC 


|AP 1 


1 CZCJD 


1 CZCJDC 


|AJ 1 


1 CZCJT 


1 CZCJTM 


|AA 1 


1 CZCJT 


1 CZCJTM 


|AG 1 


1 CZCJT 


CZCJTM 


iAB 1 


ICZCJI 


CZCJIC 


AK 1 


ICZCJL 


CZCJLV 


'ao 1 


1 CZCJT 


CZCJTM 


AG 1 


1 CZCJT 


CZCTTM 


AB 1 


1 CZCJTT 


[ CZCJPS 


none | 


1 CZCJT 


CZCJPS 


none | 


1 CZCJS 
1 


CZCJSC 


AI 1 


1 

1 CZCJT 

1 


CZCJTM 


AE 1 


1 

1 CZCJT 

1 


CZCJPS 


none | 


1 

1 CZCJT 

1 


CZCJPS 


none | 


1 

1 CZCJT 

t 


CZCJTM 


AE 1 


1 

1 CZCJT 

i 


CZCJPS 


none | 


1 

[CZCJT 

1 


CZCJTM 


AA 1 


1 

1 CZCJT 
1 


CZCJTM 


AB 1 


1 

1 CZCJT 
1 


CZCJTM 


AC 1 


1 

1 CZCJT 

1 


CZCJTM 


AF 1 


1 

1 CZCJT 

1 


CZCJTM 


AD 1 


1 1 
1 CZCJT 

1 ' 


CZCJTM 


AF 1 


1 CZC JX 

i 1 


CZCJXX i 


none j 


1 1 

ICZCJY 

1 1 


CZCJYC 1 


AL 1 


1 1 
ICZCJZ 1 
1 1 


CZCJZC 1 


AM 1 


1 1 
1 CZCJT 1 

1 1 


CZCJTM 1 


AH 1 


1 1 
[CZCJT i 
1 


CZCJTM 1 




1 1 

JL J 


,__ _j 


j 
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Table 6. 1 


['ask Moni 


r — T" 1 

1 M, Length! 

1 , , , , ,, „. 1 , _ j_ 


r ~ T 

1 PSNPSA 


1 T 

76B 1 


1 PSSAl 


76B 1 


1 PSSA2 


76B 1 


1 PSSAID 


76B 1 


1 PSIDLS 


120B 1 


1 PSSCLS 


120B 1 


1 PSSAQL 


76B 1 


1 PSSASC 


76B 1 


1 PSSARP 


76B 1 


1 PSSJ^RD 


76B 1 


1 PSSADS 


76B 1 


1 PSRASA 


140B 1 


1 PSSDS5 


32B 1 


1 PSSEP2 


4%B 1 


1 PSSDILE 


8B I 


1 PSDLE 


16B 1 


1 PSCDLF 


16B 1 


1 PSCDLG 


16B 1 


1 PSCDPL 


8B 1 


1 PSCDPLl 


24B 1 


1 PLQLE 


16B 1 


1 PSCB4SW 


12B 1 


1 GATEPL 


28B 1 


1 PSDIAl 


16B 1 


I PSLCSA 


12B I 


1 PSDESA 


12B 1 


1 PSGMBV 


2*»B 1 


1 PSPCVC 


8B i 


1 PSAIVC 


8B 1 


1 PSEXPC 


8B 1 



Task Monitor Prototype Control Section (Part 1 of 2) 



Description 



Nonprivileged save area 

Privileged save area 1 

Privileged save area 2 

Implicit dynamic loader (relocation) save area 

Implicit dynamic loader (relocation) long save 
area 

Scanner long save area 

Queue linkage entry save area 

Scanner save area 

Restore privilege (RSPRV) save area 

Explicit dynamic linkage save area 

Data set paging save area 

Short save areas for flags, return codes, point- 
ers, masks, and VPSWS 

Scanner short save area 

Save area for scan at entry point 2 

V- and R-con for DIAGNO 

Enter V- and R-con (SVC 116) 

V- and R-con for CLIC (SVC 119) 

V- and R-con for CLIP (SVC 118) 

Queue index and information for privileged LE 

V- and R-con for RTRN (SVC 122) 

V- and R-con and parameter list for GATE routines 

QLE information 

Pointers 

V- and R-con and parameter list for the dynamic 
loader (relocation exception) 

Dynamic loader parameters for DLINK SVC 

V- and R-con for DELETE SVC 

GETMAIN and FREEMAIN V-cons, R-con, and constant 

V- and R-con for PCS call 

Logon V- and R-con 

External interruption processor V- and R-con 



I 
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Table 6. Task Monitor Prototype Control Section CPaart 2 of 2) 
I At I Length] Description 





PSACU¥ 


i 12B 


1 Cleanup ¥- and R-con j 




PSAHD3 


8B 


1 External interruption subprocessor ¥- and R-con | 




PSASCV 


8B 


1 Set clock ¥~ and R-con | 




PSABENDV 


8B 


1 ABEND ¥~ and R-con | 


1- 


PSADSV 


8B 

. 


¥MIER ¥- and R-con | 


, 


_, 


¥SS Entry Points | 


PSAVPV 


8B 


CZHNPA—Program interruption processor j 




PSAVS¥ 


8B 


CZHN¥B — S¥C interruption processor | 




PSAVXV 


8B 


CZHNEA- -External interruption processor | 




PSAVAV 


8B 


CZHN¥C — Asynchronous I/O interruption processor | 




PSAVT¥ 


8B 


CZHN¥D — Timer interruption processor | 




PSA¥IV 


8B 


CZHSBB — Synchronous I/O interruption processor | 




PSA¥R¥ 


8B 


CZHN¥E^ — Data set paging interruption processor f 


1"- 


PSA¥SS 


8B 


CZHN¥A — ¥SS interruption processor | 

I J 


PSLPL 


28B 1 


r i 
Parameter lists for QLE for each interruption | 
type 1 




TSCPQT 


48B 


Queue index numbers for QEs and QELs | 




PSAITB 


lO^IB 


Task monitor internal adcons — ^save areas ^ scan | 
subroutines, QLE subroutines, and tables | 




PSACPL 


19B 1 


Parameter list for setting task clock 15 on | 
attention interruptions with the P3 flag on | 




MESS251 


102B 


Messages and message lengths | 




CZCJTB 


16B 


Header for real time clocks [ 




CZCJTD 


384B 


Real time clocks | 




CZCJTH 


16B 


Header for task time clocks | 




CZCJTC 


384B 


Task time clocks | 




TMS¥C 


48B 


Entry points within S¥C processor | 




PRI¥SA¥1 


256B 


Privileged PDSA | 




IDL¥SW 


5B 


Three flags and two flag save areas | 




CZCJTL 


162B 


Task interruptions log | 
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Table 



System 

"T "' T' 

I Hex I 
■+ +- 



Enter Codes (Part 1 of 2) 
Name 



j Decimal 



I Entry Point | PSECT | 









TAM 










1 


I 




REM)/WRITE 






czcYm 


1 CZCYMP 1 


1 1 


1 1 




BATCH MONITOR 






CZABAE 


1 CZABAE 1 


l— ' 


^. . 


-+~" 


. 




+- 


— 


-+- — — ^ 








INTERRUPT HANDLING 








1 16 


1 10 




SIR 






CZCJSA 


1 CZCJSP I 


1 17 


1 11 




DIR 






CZCJDA 


1 CZCJDP 1 


1 18 


I 12 




INTINQ 






CZCJIA 


I CZCJIP 1 


1 19 


I 13 


-+ 


STIMER/TTIMER 




+-. 


CZCJAl 


1 CZCJAR 1 




SAM 






I 32 


1 20 




READ/WRITE 






CZCRAS 


1 CZCRAP 1 


1 33 


1 21 




CHECK 






CZCRCS 


1 CZCRCP 1 


1 34 


1 22 




CNTRL 






CZCRBS 


1 CZCRBP 1 


1 36 


1 24 




POINT 






CZCRMA 


1 CZCRMP 1 


1 37 


1 25 




BSP 






CZCRGA 


1 CZCRGP 1 


|. , 


— . 1- 


— 1 


VM ALLOCATION 




4- 


— 


-+ 4 


1 48 


1 30 




GETMAIN (R) 






CZCH2 


1 CZCH5 1 


1 ^9 


1 31 




GET MAIN CPAGE) 






CZCG2 


1 CZCG5 1 


1 50 


1 32 




FREEMAIN CR) 






C2;CH3 


1 CZCH5 1 


1 51 


I 33 


—J-——— 


FREEMAIN (PAGE) 




J 


CZCG3 


1 CZCG5 1 

L„ 1 










—«—.——._——«—« 


— ^- ^ 








VAM GENERAL SERVICES 








1 56 


1 38 




VDMEP 






CZCQKl 


1 CZCAKP 1 


1 57 


I 39 




DUPOPEN 






CZCQKl 


1 CZCQKP 1 


I 58 


1 3h 

+ 


-+ — 


DUPCLOSE 




.f- 


CZCEYl 


1 CZCEYP i 




VIS AM 






1 61 


1 3D 




VISAM SETL 






CZCPC3 


1 CZCPC3 1 


I- 


^ 


— 1 


VAM 




■-(— 


— , 


"+ i 


1 62 


1 3E 




VSAM PUT 






CZCOS3 


1 CZC0S3 1 


1 63 


1 3F 




LIBESRCH 






CZCDL3 


1 CZCDLP 1 


1 64 


1 40 




READ/WRITE 






CZCPEl 


1 CZCPEP 1 


1 65 


1 41 




ESETL 






CZCPDl 


1 CZCPIP 1 


1 66 


1 42 




RELEX 






CZCPGl 


1 CZCPIP 1 


1 67 


1 43 




DET.REC 






CZCPHl 


1 CZCPEP 1 


1 68 


1 44 




FIND 






CZCOJl 


1 CZCOJP 1 


1 69 


1 45 




STOW 






CZCOKl 


1 CZCOKP 1 


1 70 


1 ^6 




ADE 






CZCPLl 


1 CZCPLP 1 


1 71 


1 47 




GETPAGE 






CZCPIl 


1 CZCPIP 1 


1 72 


1 48 




INS PACE 






CZCODl 


t CECODP I 


1 73 


1 49 




DELPAGE 






CZC0D2 


1 CZCODP 1 


1 74 


1 4A 




VSAM PUT EXTERNAL USER 




CZCOSl 


t CZCOSP 1 


1 75 


1 **B 




VSAM PUT INTERNAL 




CZC0S2 


1 CZCOSP 1 


1 76 


I 4C 




MOVEPAGE 






CZCOCl 


1 CZCOCP 1 


1 77 


1 ^D 




FliJSHBUF 






CZCOVl 


1 CZCOVP 1 


1 78 


1 4E 




VISAM GET PAGE 


INPUT 




CZCPI2 


1 CZCPIP 1 


1 79 


1 ^F 

+ 


-+— 


VISAM GET PAGE 


OUTPUT 


— +- 


CZCPI3 


1 CZCPIP 1 


MACRO COMMAND LANGUAGE 




1 80 


1 50 




GATRD/GATWR 






CZATC2 


1 CZATCP 1 


1 81 


1 51 




WTO 






CZABQl 


I CZABQR 1 


1 82 


1 52 




WTOR 






CZABQl 


1 CZABQR 1 


1 83 


1 53 




ERASE 






CZAEJ7 


1 CZAEJR I 
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Table 7 . 

r 

I Decimal 



System 

■T T- 

I Hex I 
4~— +- 



Enter Codes (Part 2 of 2> 
Name 



I Entry Point j PSECT | 







1 MACRO COMMAND LANGUAGE 








1 8i| 


1 54 


1 DATADEF 








CEAEA3 


i CZAEAR 1 


1 B5 


55 


DDCALL 








CZAFS2 


1 CZAFSR 1 


1 86 


56 


ABEND 








CZACPl 


1 CZACPR 1 


1 87 


57 


CARD 








CZABD7 


j CZABDR I 


1 88 


58 


TAPE 








CZABD9 


1 CZABDR 1 


1 89 


59 


1 LIST 








CZABD3 


i CZABDR 1 


1 90 


5A 


1 CATALOG 








CZAEI2 


1 CZAEIR 1 


1 91 


5B 


1 UNCATLG 








CZAEJ5 


CZAEJR 1 


1 92 


5C 


DSCOPY 








CZAFV2 


1 CZAFVR f 


1 94 


5E 


1 WTL 








CZABQl 


CZABQR 1 


1 95 


5F 


US ATT 








CZASA6 


1 CZASAP 1 


1 96 


60 


FINDJFCB 






CZAEBl 


CZAEBR 1 


1 97 


61 


CLATT 








CZASA7 


CZASAP 1 


1 98 


62 


RELEASE 








CZAFJ2 


1 CZAFJR 1 


1 99 


63 


USAGE 








CZAGBl 


CZAGP 1 


1 100 


64 


FINDDS 








CZAECl 


1 CZAECR 1 


1 101 


65 


JCGWR 








CZAAD3 


CZAADR 1 


1 102 


66 




UPDTUSER 




-+- 


CZAGC2 


1 CZAGCR 1 


^ ^. 

GENERAL 


SERVICES 




1 112 


70 


lOREQ 








CZCSBl 


CZCSBR 1 


1 113 


71 


MSAM READ/WRITE 




CZCMFl 


CZCMFP 1 


1 lltl 


72 


MSAM - SET UNIT RECORD 




CZCMDl 


CZCMDP 1 


1 115 


73 


MSAM FINISH 






CZCMHl 


CZCMHP 1 


1 128 


80 


OLTAM - 


DEV, 


ALLOC • 




CZATGl 


CZATGP 1 


1 129 


81 


OLTAM - 


EX. I/O 




CZATAl 


CZATAP 1 


1 130 


82 


OLTAM - 


POSTING 




CZATBl 


CZATBP 1 


1 131 


83 


OLTAM - 


TEST 


COBPiAND 




CZATSl 


CZATSP 1 


1 144 


90 


OPEN 








CZCLAD 


CZCLAB 1 


1 145 


91 


CLOSE 








CZCLBC 


CZCLBP 1 


1 146 


92 


FEOV 








CZCLDF 


CZCLDB I 


1 147 


93 


RFR 








CZASD3 


CZASDP 1 


1 148 


94 


GDV 








CZASDX 


CZASDP 1 


1 149 


95 


AETD 








CZASB5 


CZASBP 1 


1 150 


96 


OBEY 








CZASA4 


CZASAP 1 


1 151 


97 


MCAST 








CZATUl 


CZATUP 1 


I 152 


98 


SYSIN 








CZASC7 


CZASCP 1 


1 153 


99 


LPCINIT 








CZASWl 


CZAMZP 1 


1 154 


9i^ 


LPCEDIT 








CZASW4 


CZAMZP 1 


1 155 


9B 


PRMPT 








CZATJl 


CZATJP 1 


1 156 


9C 


ATTN 








CZASB2 


CZASBP 1 


1 157 


9D 


GATE 








CZATC2 


CZATCP 1 


1 158 


9E 


ENTRFR 








CZASD5 


CZASDP 1 


1 159 


9F 


DELENT 








CZASD6 i 


CZASDP 1 


1 160 


AO 


CSTORE 








CZCKZl 


CZCKDP 1 


1 161 


Al 


NXTRFR 








CZASD4 i 


CZASDP 1 


1 162 


A2 


DICTIONARY HANDLER 




CZASD2 


CZASDP 1 


1- 




h 





. — - 


-+-' 


. 


h ^' ^ 


1 191 




RESERVED FOR 


TSS/360 USERS 








1 254 














1 
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TASK JJONITOR ENTER TABLES 

Enter Tables 1 and 2 (CHJUE^Tl S CimET2) 

Enter Tables 1 and 2 (ETl and ET2) are private tables for the use of 
the task monitor ENTER SVC routine. 

ETl consists of one word for each possible enter code beginning with 
zero* For assigned enter codes the corresponding word in the table con- 
tains a pointer to an entry in ET2| for unassigned enter codes, the 
corresponding word contains all zeros* 

ET2 contains an entry for each assigned enter code and can be 
accessed only by pointers in ETl, 

Figures 12 and 13 illustrate ETl and ET2, respectively. 

Note ; When enter code is invalid, the entry word contains all zeros; 
for a valid enter code, the entry word contains a pointer to ET2. 



HEX DEC 



-4 bytes ■ 



ETIHVC 



ET1FST 



Second ENTER code entry 



Last ENTER code entry 



Figure 12. Enter Table 1 (CHIffiTl) 



LOCATN OBJECT CODE ADDRl A0DR2 STNNT 



SOURCE STATEMENT 



000000 
000000 
000004 



0021 


COPY CHAETl 


0022**** 




♦*« 


0023* 


HAETl 




0024*CHAET1 


OSECT 




0025****** 




TASK NONITOR ENTER TABLE I 


0026****** 




TO ENTRIES IN ENTER TABIE 2 


0027* 


OS 


OF 


0028*ET1HVC 


DS 


f HIGHEST VALID ENTER CODE 


0029*ET1FST 


DS 


F ADDRESS OF 1ST ENTER CODE 


0030* 


CSECT 





CONTAINS POINTERS 
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HEX DEC 







4 bytes 



1 byte 



ET2FB1 



3 byt 



es 



ET2SVC 



ET2VC 



ET2RC 



'\ 



. V and R CON group 
/ type entry- 3 words 



Figure 13- Enter Table 2 (amET2) 



LOC&TN OBJECT CODE 



OOOPOO 
000000 
000000 
000080 
000000 
000040 
000000 
00002.0 
000001 
000004 
000008 
000004 
000004 



4DDR1 AD0P2 STMNT 



SOURCE STATEMENT 



0032 


COPY 


CHAET2 




0033**** 




4:4^^. 




0034* 


HAET2 






0035*CHAET2 


DSECT 






0036****** 




TASK MONITOR t^i^E^ ^ 


Anlr 2 


0037* 


OS 


OF 




0038*ET2FB1 


DS 


XL I INDICATOR w:jWD 


I S T '--^ Y r F 


0039*ET2TY 


EOU 


ET2FBI TYPF - V A;, 


H r N 


0040*ET2TYM 


EQU 


X'80' i - /^DCCN CP.r- 


P 


0041*ET2IS 


EQU 


ET2FB1 IHJ . S'rATijS ■>' 


-- NOT !'•/•, . 


0042*ET2IS^ 


EQU 


X»40« 1 - i'sJTEHRUPl^ 


bi e 


0043*ET2P1 


EQU 


ET2FB1 PI SETTING ( 


! - SET P. iFf^ 


0044*ET2P1M 


EOU 


X«20» I - ":5T PI Or: 




0045* 


DS 


XL3 NO^ USED 




0046*ET2VC 


OS 


f V CON 




0047*ET?RC 


DS 


F R CON 




0048* 


ORG 


ET2VC ADC ON GROUP 




0049*ET2SVC 


DS 


H BEGINNING OF i-\D^:OH GPOUP 


0050**** 


TO ACCESS THE AOCGN GROUPi 


THE ADC .,ND i^RO 


0051* 


CSECT 







CZCJTL 



JLOCAD = Current available entry address 



JLOFAD = First entry address 



JLOLAD = Last entry address 



Entries 



Interrupt type 



OLD VPSW 



OLD VPSW cont 



Figure 14. Task Monitor Interruption Log 
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INDEX 



Where more than one page reference is 
given, the major reference is first. 



asynchronous I/O interruption 
processor 28 , 58 
type 3 



binary interval 43 



cancel clock routine 42,76 

CANCEL function 40-41 

CARE 17 

CHAETl 97 

CHAET2 98 

CHAITB (see interruption table) 

cleanup routine 44-45,15,79 

CLIC SVC 24,52 

CLIP SVC 24,52 

clock routines 9 

cancel clock 42 

set clock 41-42 

time conversion 42-44 
clocks, task monitor 84,92 
COMAREA Csee communications area) 
comn^nd system 24 
communications area 

abbreviation 4 

contents 84 

user-supplied 6,87 
conversion , time 42-44 
currently active RE (CARE) 17 
CZCJA 40-41,75 
CZCJC 44-45,79 
CZCJD 37-38,70-71 
CZCJI 38-40,72-74 
CZCJL 44,78 
CZCJS 36-37,69 
CZCJT 23-36,50-68 
CZCJX 42-44 
CZCJY 41-42,77 
CZCJZ 42,76 



data set paging interruption 

processor 28,59 
data reference by task monitor modules 91 
day of a month 43 
day of a year 43 
day of the week 43 
DE (see device entry) 
decimal interval 43 
delayed dispatch 14,11 
delete interruption routine 

(DIR) 37-38,6,72-73 
DILET SVC 25,12,53 
device entry (DE) 



abbreviation 4 

contents 83 

operation 11,14 

position on ITB 13,85 
DIAGNO 34 

DIR (delete interruption 
routine) 37-38,6,70-71 
directory, microfiche 92 
dispatching 

delayed 14,17 

of interruption handling routines 11,20 

method of 34 

operation 11 , 17 

of task monitor interruption 
processors 12 
DLINK SVC 26,12,53 
dynamic loader 3,23,26 



12 



15,19,20 
25 



ENTER SVC 

dispatching requirement 

flowchart 54 

in type- II linkage 

routine description 
enter tables 84,97-98 
EXIT SVC 24,52 
external interruption 

processor 27-28,57 

type 3 

HARE (highest active request entry) 17 



ICB (see interruption control block) 

inhibiting interruptions 17 

implicit dynamic linkage (see relocation 

exception) 
interruption control block (ICB) 

abbreviation 4 

contents 83 

relationship to other control blocks 87 

used in dispatching 17,19 

user- built 6,18,20 
interruption device entry (DE) (see device 

entry) 
interruption handling routines 

dispatching of 11,17,20 

input to QLE 14 

user-specified 6,18,19 
interruption inquiry routine 

(INTINQ) 38-40,72-74 
interruption processing 11 

asynchronous I/O 28,58 

external 27-28,57 

data set paging 28,59 

program 23-24, 20,50-51 

SVC 24-26,52-54 

synchronous I/O 28,58 

timer 26-27,55-56 
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VSS 28-29,59 
interruption PSW 10 
interruption queue entry (QE) (see queue 

entry) 
interruption request entry (RE) (see 

request entry) 
interruption storage area (ISA) 

abbreviation 4 

contents 83,10,17 

input to QLE 1<* 

long save 12 

relationship to TBG>SECT 85 
interruption table (ITB) 

abbreviation 4 

contents 83 

output from QLE 14 

relationship to other control blocks 83 

simplified view 13 

use in interruption processing 11,20 
INTINQ 38-1*0,72-74 
I/O interruptions 4 

asynchronous 4,28,58 

synchronous 4 , 28 , 58 
ISA (see interruption storage area) 
ITB (see interruption table) 



leave privilege routine 

flowchart 78 

routine description 44 

type- II I linkage 5,16 
linkage 5 

type- I 5 

type-II 5,15,19 

type- III 5,16 
linkage conventions 5 
long save areas 11,94 
L-type 

QE 14,13 

RE 14,13 
LVPRV (see leave privilege routine) 



macro instructions 6 

AETD 6 

CLATT 6 

DIR 6,37-38 

INTINQ 38-40 

SAEC 6 

SEEC 6 

SIEC 6 

SIR 6,18,20 

SPEC 6,18,20 

SSEC 6 

STEC 6 

STIMER/TTIMER 40-41 

USATT 6 
message control block (MCB) 84,4 
method of operation (task monitor) 
microfiche directory 92 



operation, method of (task monitor) 
overall processing 11 



7-20 



7-20 



PCS CALL SVC 25-26,12,52 
PDSA (pushdown save area) 84,4,85-87 
prebuilt RE (REL) 14,13 
privilege 5,15-16 

privileged routine, linkage to 5,15 
prototype control section, task monitor 
(TMPSECT) 

abbreviation 4 

contents 84,94-95 

input to QLE 14 

relationship to ISA 85 
pushdown save area 84,4,85-87 
P3 flag 30,33 



QE (see queue entry) 

QEL 14,15 

QLE (see queue linkage entry routine) 

queue entry (QE) 

abbreviation 4 

contents 83 

in interruption table 13,85 

output from QLE 11,14 

use in interruption processing 18,20 
queue index 14 
queuing procedure 14 
queue linkage entry routine (QLE) 

flowchart 60-63 

queuing procedure 14,18 

routine description 29-32 

use in interruption processing 11,12 



RAE SVC (restore and enable SVC) 24,52 

RE (see request entry) 

real time clocks 84,92 

REL (see prebuilt RE) 

relocation exception 3,11,23 

request entry (RE) 

abbreviation 4 

contents 83 

part of ITB 13,14,85 

prebuilt 13, 14 

use in interruption processing 11,17,19 

user-specified 6,18, 20 
restore and enable SVC 24,52 
restore privilege SVC 

dispatching requirement 12 

flowchart 52 

in type-Ill linkage 16 

routine description 24 
return SVC 25,53 

RSPRV SVC (see restore privilege SVC) 
RTRN SVC 25,53 



SAEC 6 
save areas 

long (1 and 2) 83,12 

pushdown 84,4,85-87 

scanner 12,94 
scanner /dispatcher 

dispatching mechanism 11,18,20 

flowchart 64-68 

operation 17 
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routine description 32-36 
scanning procedure 11 
SDAT 84,1«»,86 
SlEC 6 

serial day 44 
set clock routine 41-42,77 
SET function 40 
SIEC 6 

SIR (see specify interruption routine) 
SOP (standard optimal procedure 

subroutine) 29,12 
SPEC 6,18,20 

specify interruption routine (SIR) 
flowchart 69 

routine description 36-37 
use of macro instruction 6,18,20 
SSEC 6 
standard optimal procedure 

subroutine 29,12 
STEC 6 

STIMER/TTIMER routine 40-41,75 
SVC interruptions 

processor 24-26,52-54 
types 3 

CLIC 24,52 
CLIP 24,52 
DELET 25,12,53 
DLINK 26,12,53 
ENTER 

dispatching requirement 12 
flowchart 54 

in type-II linkage 15,19,20 
routine description 25 
EKIT 24,52 
PCS 25-26,12,52 
RAE 24,52 
RSPRV 

dispatching requirement 12 
flowchart 52 
in type- II I linkage 16 
routine description 24 
RTRN 25,53 
symbolic device allocation table 84,4,86 
synchronous I/O interruption 4 
processor 28,58 



tables 4,83-84,85-87 

task interruption control routine (TIC) 10 
task interruption log 98 
task monitor 
functions 3 
interruption processors 
flowcharts 50-59 
input to QLE 14 
operation 11 , 12 
routine descriptions 23-29 
method of operation 7-20 
processing 11 

prototype control section (TMPSECT) 
abbreviation 4 
contents 84 , 94-95 
input to QLE 14 
relationship to ISA 85 
task-oriented interruptions 3-4 
task time clocks 84,92 
TEST function 40 
time conversion routine 42-44 
time sharing support system SVCs 3 
timer interruption 

processor 26-27,55-56 
types 4 
type-I linkage 5 
type-II linkage 5,15 
type-Ill linkage 5,16 



user-specified interruption handling 
routines 

description of use 18,19,20 

introduction 6 
Ul flag 17,33 

virtual support system 11 

VMIER (virtual memory input error recording 

routine) 23,28 
VSS interruption 4 
processor 28-29, 59 



WAIT function 41 
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